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The Intended Audience 

The Rainbow Color/ Graphics Option Programmer's Reference Guide is written for the experienced 
systems programmer who will be programming applications that display graphics on Rainbow video 
monitors. It is further assumed that the system programmer has had both graphics and 8088 pro- 
gramming experience. 

The information contained in this document is not unique to any operating system; however, it is 
specific to the 8088 hardware and 8088-based software. 

Organization of the manual 

The Rainbow Color /Graphics Option Programmer's Reference Guide is subdivided into four parts 
containing fifteen chapters and three appendixes as follows: 

• PART I — OPERATING PRINCIPLES contains the following four chapters: 

- Chapter 1 provides an overview of the Graphics Option including information on the hard- 
ware, logical interface to the CPU, general functionality, color and monochrome ranges, and 
model dependencies. 

- Chapter 2 describes the monitor configurations supported by the Graphics Option. 
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- Chapter 3 discusses the logic of data generation, bitmap addressing, and the GDC's handhng 
of the screen display. 

- Chapter 4 describes the software components of the Graphics Option such as the control 
registers, maps, and buffer areas accessible under program control. 

• PART II — PROGRAMMING GUIDELINES contains the following eight chapters: 

- Chapter 5 discusses programming the Graphics Option for initialization and control 
operations. 

- Chapter 6 discusses programming the Graphics Option for setting up bitmap write 
operations. 

- Chapter 7 discusses programming the Graphics Option for area write operations. 

- Chapter 8 discusses programming the Graphics Option for vector write operations. 

- Chapter 9 discusses programming the Graphics Option for text write operations. 

- Chapter 10 discusses programming the Graphics Option for read operations. 

- Chapter 11 discusses programming the Graphics Option for scroll operations. 

- Chapter 12 contains programming notes and timing considerations. 

• PART III — REFERENCE MATERIAL contains the following three chapters: 

- Chapter 13 provides descriptions and contents of the Graphics Option's registers, buffers, 
masks, and maps. 

- Chapter 14 provides descriptions and contents of the GDC's status register and FIFO buffer. 

- Chapter 15 provides a description of each supported GDC command arranged in alphabetic 
sequence within functional grouping. 

• PART IV — APPENDIXES contain the following three appendixes: 

- Appendix A contains the Graphics Option's Specification Summary. 

- Appendix B is a fold-out sheet containing a block diagram of the Graphics Option. 

- Appendix C lists DIGITAL'S International Help Line phone numbers. 

Suggestions for the Reader 

For more information about the Graphics Display Controller refer to the following: 

• UPD7220 GDC Design Manual— HEC Electronics U.S.A. Inc. 

• UPD7220 GDC Design Specification— HEC Electronics U.S.A. Inc. 
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For a comprehensive tutorial/reference manual on computer graphics, consider Fundamentals of 
Interactive Computer Graphics by J. D. Foley and A. Van Dam published by Addison- Wesley Publish- 
ing Company, 1982. 



Terminology 

ALU/PS 

Bitmap 

GDC 

Motherboard 

Nibble 
Pixel 

Resolution 

RGB 

RGO 
RMW 

vss 



Arithmetic Logical Unit and Plane Select (register) 
Video display memory 
Graphics Display Controller 

A term used to refer to the main circuit board where the processors and main 
memory are located — hardware options, such as the Graphics Option, plug 
into and communicate with the motherboard 

A term commonly used to refer to a half byte (4 bits) 

Picture element when referring to video display output 

A measure of the sharpness of a graphics image — usually given as the 
number of addressable picture elements for some unit of length (pixels per 
inch) 

Red, green, blue — the acronym for the primary additive colors used in color 
monitor displays 

Rainbow Graphics Option 

Read/Modify/Write, the action taken when accessing the bitmap during a write 
or read cycle 

Video Subsystem 
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Hardware Components 

The Graphics Option is a user-installable module that adds graphics and color display capabilities to 
the Rainbow system. The graphics module is based on a NEC uPD7220 Graphics Display Controller 
(GDC) and an 8 X 64K dynamic RAM video memory that is also referred to as the bitmap. 

The Graphics Option is supported, with minor differences, on Rainbow systems with either the model 
A or model B motherboard. The differences involve the number of colors and monochrome intensi- 
ties that can be simultaneously displayed and the number of colors and monochrome intensities that 
are available to be displayed (see Table 1). Chapter 5 includes a programming example of how you 
can determine which model of the motherboard is present in your system. 

Table 1. Colors and Monochrome Intensities — Displayed/ Available 





MED. RESOLUTION 


HIGH RESOLUTION 


CONFIG. 


MODEL 


COLOR 


MONO. 


COLOR 


MONO. 


MONOCHROME 

MONITOR 

ONLY 


100-A 


N/A 


4/4 


N/A 


4/4 


100-B 


N/A 


16/16 


N/A 


4/16 


COLOR 

MONITOR 

ONLY 


100-A 


1 6/1 024 


N/A 


4/1024 


N/A 


100-B 


1 6/4096 


N/A 


4/4096 


N/A 


DUAL 

MONITORS 


100-A 


1 6/4096 


4/4 


4/4096 


4/4 


100-B 


16/4096 


16/16 


4/4096 


4/16 
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The GDC, in addition to performing the housekeeping chores for the video display, can also: 

• Draw Unes at any angle 

• Draw arcs of specified radii and length 

• Fill rectangular areas 

• Transfer character bit-patterns from font tables in main memory to the bitmap 

Video Memory (Bitmap) 

The CPUs on the motherboard have no direct access to the bitmap memory. All writes are per- 
formed by the external graphics option hardware to bitmap addresses generated by the GDC. 

The bitmap is composed of eight 64K dynamic RAMs. This gives the bitmap a total of 8 X 64K of 
display memory. In high resolution mode, this memory is configured as two planes, each 8 X 32K. 
In medium resolution mode, this memory is configured as four planes, each 8 X 16K. However, as 
far as the GDC is concerned, there is only one plane. All plane interaction is transparent to the GDC. 

Although the bitmap is made up of 8 X 64K bits, the GDC sees only 16K of word addresses in high 
resolution mode (2 planes X 16 bits X 16K words). Similarly, the GDC sees only 8K of word 
addresses in medium resolution mode (4 planes X 16 bits X 8K words). Bitmap address zero is 
displayed at the upper left corner of the monitor screen. 

Additional Hardware 

The option module also contains additional hardware that enhances the performance and versatility of 
the GDC. This additional hardware includes: 

• A 16 X 8-bit Write Buffer used to store byte-aligned or word-aligned characters for high 
performance text writing or for fast block data moves from main memory to the bitmap 

• An 8-bit Pattern Register and a 4-bit Pattern Multiplier for improved vector writing 
performance 

• Address offset hardware (256 X 8-bit Scroll Map) for full and split-screen vertical scrolling 

• ALU/PS register to handle bitplane selection and the write functions of Replace, Complement, 
and Overlay 

• A 16 X 16-bit Color Map to provide easy manipulation of pixel color and monochrome 
intensities 

• Readback hardware for reading a selected bitmap memory plane into main memory 
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Resolution Modes 

The Graphics Option operates in either of two resolution modes: 

• Medium Resolution Mode 

• High Resolution Mode 

Medium Resolution Mode 

Medium resolution mode displays 384 pixels horizontally by 240 pixels vertically by four bitmap 
memory planes deep. This resolution mode allows up to 16 colors to be simultaneously displayed on a 
color monitor. Up to sixteen monochrome shades can be displayed simultaneously on a monochrome 
monitor. 

High Resolution Mode 

High resolution mode displays 800 pixels horizontally by 240 pixels vertically by two bitmap memory 
planes deep. This mode allows up to four colors to be simultaneously displayed on a color monitor. 
Up to four monochrome shades can be simultaneously displayed on a monochrome monitor. 

Operational Modes 

The Graphics Option supports the following modes of operations: 

• WORD MODE to write 16-bit words to selected planes of the bitmap memory for character and 
image generation 

• VECTOR MODE to write pixel data to bitmap addresses provided by the GDC 

• SCROLL MODE for full- and split-screen vertical scrolling and full-screen horizontal scrolling 

• READBACK MODE to read 16-bit words from a selected plane of bitmap memory for special 
applications, hardcopy generation or diagnostic purposes 
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Monitor Configurations 



In the Rainbow system with the Graphics Option installed, there are three possible monitor configu- 
rations: Monochrome only, Color only, and Dual (color and monochrome). In all three configurations, 
the selection of the option's monochrome output or the motherboard VT102 video output is con- 
trolled by bit two of the system maintenance port (port OAh). A in bit 2 selects the motherboard 
VT102 video output while a 1 in bit 2 selects the option's monochrome output. 
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Monochrome Monitor Only 

As shown in Figure 1, the monochrome monitor can display either graphics option data or 
motherboard data depending on the setting of bit 2 of port OAh. Writing an 87h to port OAh selects 
the Graphics Option data. Writing an 83h to port OAh selects the motherboard VT102 data. The red, 
green and blue data areas in the Color Map should be loaded with all F's to reduce any unnecessary 
radio frequency emissions. 

BLUE INTENSITIES 
RED INTENSITIES 
GREEN INTENSITIES 
MONOCHROME INTENSITIES 



MOTHERBOARD DATA 
PORT OAh (BIT 2) 

LJ-0215 




^MONOCHROME MONITOR 



Figure 1. Monochrome Monitor Only System 



Monitor Configurations 



Color Monitor Only 

When the system is configured with only a color monitor, as in Figure 2, the green gun does double 
duty. It either displays the green component of the graphics output or it displays the monochrome 
output of the motherboard VT102 video subsystem. Because the green gun takes monochrome 
intensities, all green intensities must be programmed into the monochrome data area of the Color 
Map. The green data area of the Color Map should be loaded with all F's to reduce any unnecessary 
radio frequency emissions. 

BLUE INTENSITIES ►BLUE GUN 

RED INTENSITIES ►RED GUN 

GREEN INTENSITIES 

MONOCHROME INTENSITIES 
(GREEN DATA) 



MOTHERBOARD DATA 
PORT OAh (BIT 2) — 

LJ-0216 

Figure 2. Color Monitor Only System 

When motherboard VT102 data is being sent to the green gun, the red and blue output must be 
turned off at the Graphics Option itself. If not, the red and blue guns will continue to receive data 
from the option and this output will overlay the motherboard VT102 data and will also be out of 
synchronization. Bit 7 of the Mode Register is the graphics option output enable bit. If this bit is a 1 
red and blue outputs are enabled. If this bit is a red and blue outputs are disabled. 

As in the monochrome only configuration, bit 2 of port OAh controls the selection of either the 
graphics option data or the motherboard VT102 data. Writing an 87h to port OAh enables the option 
data. Writing an 83h to port OAh selects the motherboard VT102 data. 




^ GREEN GUN 
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Dual Monitors 

In the configuration shown in Figure 3, both a color monitor and a monochrome monitor are available 
to the system. Motherboard VT102 video data can be displayed on the monochrome system while 
color graphics are being displayed on the color monitor. If the need should arise to display graphics 
on the monochrome monitor, the monochrome intensity output can be directed to the monochrome 
monitor by writing an 87h to port OAh . Writing an 83h to port OAh will restore motherboard 
VT102 video output to the monochrome monitor. 

BLUE INTENSITIES ► BLUE GUN 

RED INTENSITIES ► RED GUN 

GREEN INTENSITIES ► GREEN GUN 

MONOCHROME INTENSITIES ► 



MOTHERBOARD DATA 
PORT OAh (BIT 2) 

LJ-0217 

Figure 3. Dual Monitor System 

When displaying graphics on the monochrome monitor, the only difference other than the the lack of 
color is the range of intensities that can be simultaneously displayed on systems with model A 
motherboards. 

Systems with model A motherboards can display only four monochrome intensities at any one time. 
Even though sixteen entries can be selected when operating in medium resolution mode, only the 
two low-order bits of the monochrome output are active. This limits the display to only four unique 
intensities at most. On systems with the model B motherboard, all sixteen monochrome intensities 
can be displayed. 



MONOCHROME MONITOR 
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General 

The Graphics Display Controller (GDC) can operate either on one bit at a time or on an entire 16-bit 
word at a time. It is, however, limited to one address space and therefore can only write into one 
plane at a time. The Graphics Option is designed in such a manner that while the GDC is doing 
single pixel operations on just one video plane, the external hardware can be doing 16-bit word 
operations on up to four planes of video memory. 

Write operations are multi-dimensioned. They have width, depth, length and time. 

• Width refers to the number of pixels involved in the write operation. 

• Depth refers to the number of planes involved in the write operation. 

• Length refers to the number of read/modify/write cycles the GDC is programmed to perform. 

• Time refers to when the write operation occurs in relation to the normal housekeeping opera- 
tions the GDC has to perform in order to keep the monitor image stable and coherent. 
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Data Logic 

The Graphics Option can write in two modes: word mode (16 bits at a time) and vector mode (one 
pixel at a time). 

In word mode, the data patterns to be written into the bitmap are based on bit patterns loaded into 
the Write Buffer, Write Mask, and the Foreground/Background Register, along with the type of 
write operation programmed into the ALU/PS Register. 

In vector mode, the data patterns to be written to the bitmap are based on bit patterns loaded into 
the Pattern Register, the Pattern Multiplier, the Foreground/Background Register, and the type of 
write operation programmed into the ALU/PS Register. 

In either case, the data will be stored in the bitmap at a location determined by the addressing logic. 

Address Logic 

The addressing logic of the Graphics Option is responsible for coming up with the plane, the line 
within the plane, the word within the line, and even the pixel within the word under some conditions. 

The display memory on the Graphics Option is one-dimensional. The GDC scans this linear memory 
to generate the two dimensional display on the CRT. The video display is organized similarly to the 
fourth quadrant of the Cartesian plane with the origin in the upper left corner. Row addresses (y 
coordinates of pixels) start at zero and increase downwards while column addresses (x coordinates of 
pixels) start at zero and increase to the right (see Figure 4). Pixel data is stored in display memory 
by column within row. 
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COLUMN (X) 



ROW (Y) 





1 


2 





(0,0) 


(1.0) 


(2,0) 


1 


(0,1) 


(1.1) 


(2,1) 


2 


(0,2) 


(1.2) 


(2,2) 


• 
• 




M 


(0,M) 


(1.M) 


(2,M) 



(N,0) 



(N,1) 



(N,2) 



(N,M) 



Figure 4. Rows and Columns in Display Memory 



The GDC accesses the display memory as a number of 16-bit words where each bit represents a 
pixel. The number of words defined as well as the number of words displayed on each line is 
dependent on the resolution. The relationship between words and display lines is shown in Figure 5. 
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■WORDS/LINE DEFINED- 



■ WORDS/LINE DISPLAYED- 



LINE 





1 


2 




Q-1 




P-1 


LINE 1 


P 


P+1 


P+2 




P+Q-1 




2P-1 


LINE 2 


2P 


2P+1 




2P4-Q-1 




3P-1 


• 


3P 




3P+Q-1 




4P-1 


• 


4P 




4P+Q-1 




5P-1 








(M-1)P 




MP-1 






LINE N-1 


(N-1)P 




NP-1 



WHERE: 



P = WORDS/LINE DEFINED 



32 IN MEDIUM RESOLUTION. 
64 IN HIGH RESOLUTION. 



Q = WORDS/LINE DISPLAYED 



24 IN MEDIUM RESOLUTION 
50 IN HIGH RESOLUTION 



N = NO. OF LINES DEFINED 



256 



M = NO. OF LINES DISPLAYED - 240 



Figure 5. Relationship of Display Memory to Address Logic 
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In order to address specific pixels, the GDC requires the word address and the pixel location within 
that word. The conversion of pixel coordinates to addresses in display memory is accomplished by 
the following formulas: 

Given the pixel coordinates Cx,y): 

Word Address of pixel = Cwords/line defined * y) + integer Cx/ 16) 
Pixel Address within word = r emai nder ( x/ 16) * 16 

Because the Graphics Option is a multi-plane device, a way is provided to selectively enable and 
disable the reading and writing of the individual planes. This function is performed by the ALU/PS 
and Mode registers. More than one plane at a time can be enabled for a write operation; however, 
only one plane can be enabled for a read operation at any one time. 

The entire address generated by the GDC does not go directly to the bitmap. The low-order six bits 
address a word within a line in the bitmap and do go directly to the bitmap. The high-order eight bits 
address the line within the plane and these bits are used as address inputs to a Scroll Map. The 
Scroll Map acts as a translator such that the bitmap location can be selectively shifted in units of 64 
words. In high resolution mode, 64 words equate to one scan line; in medium resolution mode, they 
equate to two scan lines. This allows the displayed vertical location of an image to be moved in 64- 
word increments without actually rewriting it to the bitmap. Programs using this feature can provide 
full and split screen vertical scrolling. The Scroll Map is used in all bitmap access operations: writing, 
reading, and refreshing. 

If an application requires addressing individual pixels within a word, the two 8-bit Write Mask 
Registers can be used to provide a 16-bit mask that will write-enable selected pixels. Alternately, a 
single pixel vector write operation can be used. 

There is a difference between the number of words/line defined and the number of words/line 
displayed. In medium resolution, each scan line is 32 words long but only 24 words are displayed (24 
words * 16 bits/word = 384 pixels). The eight words not displayed are unusable. Defining the length 
of the scan line as 24 words would be a more efficient use of memory but it would take longer to 
refresh the memory. Because display memory is organized as a 256 by 256 array, it takes 256 bytes 
of scan to refresh the entire 64K byte memory. Defining the scan line length as 32 words long 
enables the entire memory to be refreshed in four line scan periods. Defining the scan line length as 
24 words long would require five line scans plus 16 bytes. 

Similarly, in high resolution, each scan line is 64 words long but only 50 words are displayed. With a 
64 word scan line length, it takes two line scan periods to refresh the entire 64K byte memory. If 
the scan line length were 50 words, it would take two lines plus 56 bytes to refresh the memory. 

Another advantage to defining scan line length as 32 or 64 words is that cursor locating can be 
accompUshed by a series of shift instructions which are considerably faster than multiplying. 
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Display Logic 

The display logic of the Graphics Option will be discussed as it applies to both the bitmap and the 
screen. 

Bitmap Logic 

Data in the bitmap does not go directly to the monitor. Instead, the bitmap data is used as an 
address into a Color Map. The output of this Color Map, which has been preloaded with color and 
monochrome intensity values, is the data that is sent to the monitor. 

In medium resolution mode there are four planes to the bitmap; each plane providing an address bit 
to the Color Map. Four bits can address sixteen unique locations at most. This gives a maximum of 
16 addressable Color Map entries. Each Color Map entry is 16 bits wide. Four of the bits are used 
to drive the color monitor's red gun, four go to the green gun, four go to the blue gun, and four 
drive the output to the monochrome monitor. In systems with the Model 100-A motherboard, only 
the two low-order bits of the monochrome output are used. Therefore, although there are 16 possi- 
ble monochrome selections in the Color Map, the number of unique intensities that can be sent to 
the monochrome monitor is four. 

In high resolution mode there are two planes to the bitmap; each plane providing an address bit to 
the Color Map. Two bits can address four entries in the Color Map at most. Again, each Color Map 
entry is sixteen bits wide with 12 bits of information used for color and four used for monochrome 
shades. In systems with the Model 100-A motherboard, only the two low-order bits of the mono- 
chrome output are used. This limits the number of unique monochrome intensities to four. 

Although the Color Map is 16 bits wide, the color intensity values are loaded one byte at a time. 
First, the 16 pairs of values representing the red and green intensities are loaded into bits through 
7 of the map. Then, the 16 pairs of values representing the blue and monochrome intensities are 
loaded into bits 8 through 15 of the map. 
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Screen Logic 

The image displayed on the screen is generated by an electron beam performing a series of horizon- 
tal line scans from left to right. At the end of each horizontal scan line, a horizontal retrace takes 
place at which time the electron beam reverses its horizontal direction. During this horizontal 
retrace, the electron beam is also being moved down to the beginning of the next scan line. When 
the last line has completed its horizontal retrace, a vertical retrace takes place at which time the 
electron beam's vertical movement is reversed and the beam is positioned at the beginning of the 
first scan line. 

The GDC writes to the bitmap only during the screen's horizontal and vertical retrace periods. 
During active screen time, the GDC is taking information out of the bitmap and presenting it to the 
video screen hardware. For example, if the GDC is drawing a vector to the bitmap, it will stop 
writing during active screen time and resume writing the vector at the next horizontal or vertical 
retrace. 

In addition to the active screen time and the horizontal and vertical retrace times, there are several 
other screen control parameters that precede and follow the active horizontal scans and active lines. 
These are the Vertical Front and Back Porches and the Horizontal Front and Back Porches. The 
relationship between the screen control parameters is shown in Figure 6. Taking all the parameters 
into account, the proportion of active screen time to bitmap writing time is approximately four to 
one. 
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GDC VIDEO CONTROL PARAMETERS 



CLXLii 




VERTICAL 
BACK 

PORCH / 
(16 LINES) 
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Figure 6. GDC Screen Control Parameters 
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GDC Command Logic 

Commands are passed to the GDC command processor from the Rainbow system by writing com- 
mand bytes to port 57h and parameter bytes to port 56h. Data written to these two ports is stored 
in the GDC's FIFO buffer, a 16 x 9-bit area that is used to both read from and write to the GDC. 
The FIFO buffer operates in half-duplex mode — passing data in both directions, one direction at a 
time. The direction of data flow at any one time is controlled by GDC commands. 

When commands are stored in the FIFO buffer, a flag bit is associated with each data byte depending 
on whether the data byte was written to the command address (57h) or the parameter address (56h). 
A flag bit of 1 denotes a command byte; a flag bit of denotes a parameter byte. The command 
processor tests this flag bit as it interprets the contents of the FIFO buffer. 

The receipt of a command byte by the command processor signifies the end of the previous com- 
mand and any associated parameters. If the command is one that requires a response from the GDC 
such as RDAT, the FIFO buffer is automatically placed into read mode and the buffer direction is 
reversed. The specified data from the bitmap is loaded into the FIFO buffer and can be accessed by 
the system using read operations to port 57h. Any commands or parameters in the FIFO buffer that 
follow the read command are lost when the FIFO buffer's direction is reversed. 

When the FIFO buffer is in read mode, any command byte written to port 57h will immediately 
terminate the read operation and reverse the buffer direction to write mode. Any data that has not 
been read by the Rainbow system from the FIFO buffer will be lost. 
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I/O Ports 

The CPUs on the Rainbow system's motherboard use a number of 8-bit I/O ports to exchange 
information with the various subsystems and options. The I/O ports assigned to the Graphics Option 
are ports 50h through 57h. They are used to generate and display graphic images, inquire status, 
and read the contents of video memory (bitmap). The function of each of the Graphics Option's I/O 
ports is as follows: 

Port Function 

50h Graphics option software reset. Any write to this port also resynchronizes the 
read/modify/write memory cycles of the Graphics Option to those of the GDC. 

51h Data written to this port is loaded into the area selected by the previous write to port 53h. 

52h Data written to this port is loaded into the Write Buffer. 

53h Data written to this port provides address selection for indirect addressing (see Indirect 
Register). 

54h Data written to this port is loaded into the low-order byte of the Write Mask. 
55h Data written to this port is loaded into the high-order byte of the Write Mask. 
56h Data written to this port is loaded into the GDC's FIFO Buffer and flagged as a parameter. 

Data read from this port reflects the GDC status. 
57h Data written to this port is loaded into the GDC's FIFO Buffer and flagged as a command. 

Data read from this port reflects information extracted from the bitmap. 
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Indirect Register 

The Graphics Option uses indirect addressing to enable it to address more registers and storage 
areas on the option module than there are address lines (ports) to accommodate them. Indirect 
addressing involves writing to two ports. A write to port 53h loads the Indirect Register with a bit 
array in which each bit selects one of eight areas. 

The Indirect Register bits and the corresponding areas are as follows: 



Bit 


Area Selected 





Write Buffer (*) 


1 


Pattern Multiplier 


2 


Pattern Register 


3 


Foreground/Background Register 


4 


ALU/PS Register 


5 


Color Map (*) 


6 


Mode Register 


7 


Scroll Map (*) 


(*) 


Also clears the associated index counter 



After selecting an area by writing to port 53h, you access and load data into most selected areas by 
writing to port 51h. For the Write Buffer however, you need both a write of anything to port 51h to 
access the buffer and clear the counter and then a write to port 52h to load the data. 

Write Buffer 

A 16 X 8-bit Write Buffer provides the data for the bitmap when the Graphics Option is in Word 
Mode. You can use the buffer to transfer blocks of data from the system's memory to the bitmap. 
The data can be full screen images of the bitmap or bit-pattern representations of font characters 
that have been stored in motherboard memory. The buffer has an associated index counter that is 
cleared when the Write Buffer is selected. 

Although the CPU accesses the Write Buffer as sixteen 8-bit bytes, the GDC accesses the buffer as 
eight 16-bit words. (See Figure 7.) A 16-bit Write Mask gives the GDC control over individual bits 
of a word. 
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AS THE CPU ACCESSES IT AS THE GDC ACCESSES IT 

BYTE HIGH BYTE LOW BYTE WORD WORD 

7 7 15 

I I I 

1 
2 

4 

5 

6 

7 ^ 

LJ-0221 

Figure 7. Write Buffer as Accessed by the CPU and the GDC 

The output of the Write Buffer is the inverse of its input. If a word is written into the buffer as 
FFB6h, it will be read out of the buffer as 0049h. To have the same data written out to the bitmap 
as was received from the CPU requires an added inversion step. You can exclusive or (XOR) the 
CPU data with FFh to pre-invert the data before going through the Write Buffer. Alternately, you 
can write zeros into the Foreground Register and ones into the Background Register to re-invert the 
data after it leaves the Write Buffer and before it is written to the bitmap. Use one method or the 
other, not both. 

In order to load data into the Write Buffer, you first write an FEh to port 53h and any value to port 
51h. This not only selects the Write Buffer but also sets the Write Buffer Index Counter to zero. 
The data is then loaded into the buffer by writing it to port 52h in high-byte low-byte order. If more 
than 16 bytes are written to the buffer the first 16 bytes will be overwritten. 

If you load the buffer with less than 16 bytes (or other than a multiple of 16 bytes for some reason 
or other) the GDC will find an index value other than zero in the counter. Starting at a location other 
than zero alters the data intended for the bitmap. Therefore, before the GDC is given the command 
to write to the bitmap, you must again clear the Write Buffer Index Counter so that the GDC will 
start accessing the data at word zero. 



0,1 
2,3 
4,5 
6,7 
8,9 
10,11 
12,13 
14,15 
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Write Mask Registers 

When the Graphics Option is in Word Mode, bitmap operations are carried out in units of 16-bit 
words. A 16-bit Write Mask controls the writing of individual bits within a word. A zero in a bit 
position of the mask allows writing to the corresponding position of the word. A one in a bit position 
of the mask disables writing to the corresponding position of the word. 

While the GDC accesses the mask as a 16-bit word, the CPU accesses the mask as two of the 
Graphic Option's I/O ports. The high-order Write Mask Register is loaded with a write to port 55h 
and corresponds to bits 15 through 8 of the Write Mask. The low-order Write Mask Register is 
loaded with a write to port 54h and corresponds to bits 7 through of the Write Mask. (See Figure 



8.) 
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THE CPU 
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PORT 54h 



I 



i 



7 
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Figure 8. Write Mask Registers 
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Pattern Generator 

When the Graphics Option is in Vector Mode, the Pattern Generator provides the data to be written 
to the bitmap. The Pattern Generator is composed of a Pattern Register and a Pattern MultipUer. 

The Pattern Register is an 8-bit recirculating shift register that is first selected by writing FBh to 
port 53h and then loaded by writing an 8-bit data pattern to port 51h. 

The Pattern Multiplier is a 4-bit register that is first selected by writing FDh to port 53h and then 
loaded by writing a value of 0-Fh to port 51h. 

NOTE 

You must load the Pattern Multiplier before loading the Pattern Register. 

Figure 9 shows the logic of the Pattern Generator. Data destined for the bitmap originates from the 
low-order bit of the Pattern Register. That same bit continues to be the output until the Pattern 
Register is shifted. When the most significant bit of the Pattern Register has completed its output 
cycle, the next bit to shift out will be the least significant bit again. 



OPTION 
CLOCK 



PATTERN MULTIPLIER- 
(LOADED FROM CPU) 



MULTIPLIER 



SHIFT 
CLOCK 



PATTERN REGISTER - 
(LOADED FROM CPU) 



DATA PATTERN 



SHIFTED BITS RECIRCULATED 



DATA BIT OUTPUT 
TO WRITE CIRCUITRY 
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Figure 9. Pattern Generator 
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The shift frequency is the write frequency from the option clock divided by 16 minus the value in 
the Pattern Multiplier. For example, if the value in the Pattern Multiplier is 12, the shift frequency 
divisor would be 16 minus 12 or four. The shift frequency would be one fourth of the write fre- 
quency and therefore each bit in the Pattern Register would be repUcated in the output stream four 
times. A multipher of 15 would take 16 - 15 or one write cycle for each Pattern Register bit shifted 
out. A multipher of five would take 16 - 5 or 11 write cycles for each bit in the Pattern Register. 

NOTE 

Do not change the contents of the Pattern Multiplier or the Pattern Regis- 
ter before the GDC has completed all pending vector mode write opera- 
tions. If you do, the vector pattern that is in the process of being displayed 
will take on the new characteristics of the Pattern Generator. 

Foreground/Background Register 

The Foreground/Background Register is an eight-bit write-only register. The high-order nibble is the 
Foreground Register; the low-order nibble is the Background Register. Each of the four bitmap 
planes has a Foreground/Background bit-pair associated with it (see Figure 10). The bit settings in 
the Foreground/Background Register, along with the mode specified in the ALU/PS Register, deter- 
mine the data that is eventually received by the bitmap. For example; if the mode is REPLACE, an 
incoming data bit of is replaced by the corresponding bit in the Background Register. If the 
incoming data bit is a 1, the bit would be replaced by the corresponding bit in the Foreground 
Register. 

Each bitmap plane has its own individual Foreground/Background bit pair. Therefore, it is possible 
for two enabled planes to use the same incoming data pattern and end up with different bitmap 
patterns. 



4-6 



Graphics Option Components 



FOREGROUND 
REGISTER 



BACKGROUND 
REGISTER 



7 






4 


3 









3 


2 


1 





3 


2 


1 






PLANE 



PLANE 1 



PLANE 2 



PLANE 3 



LJ-0224 



Figure 10. Foreground/Background Register 



NOTE 

Do not change the contents of the Foreground/Background Register before 
the GDC has completed all pending write operations. If you do, the informa- 
tion that is in the process of being displayed will take on the new values of 
the Foreground/Background Register. 



4-7 



Graphics Option Components 



ALU/PS Register 

The ALU/PS Register has two functions. 

Bits through 3 of the ALU/PS Register are used to inhibit writes to one or more of the bitmap 
planes. If you could not inhibit writes to the bitmap planes, each write operation would affect all 
available planes. When a plane select bit is set to 1, writes to that plane will be inhibited. When a 
plane select bit is set to 0, writes to that plane will be allowed. 

NOTE 

During a readback mode operation, all plane select bits should be set to 
ones to prevent accidental changes to the bitmap data. 

Bits 4 and 5 of the ALU/PS Register define an arithmetic logic unit function. The three logic 
functions supported by the option are REPLACE, COMPLEMENT, and OVERLAY. These functions 
operate on the incoming data from the Write Buffer or the Pattern Generator as modified by the 
Foreground/Background Register as well as the current data in the bitmap and generate the new 
data to be placed into the bitmap. 

When the logic unit is operating in REPLACE mode, the current data in the bitmap is replaced by 
the Foreground/Background data selected as follows: 

• An incoming data bit selects the Background data. 

• An incoming data bit 1 selects the Foreground data. 

When the logic unit is operating in COMPLEMENT mode, the current data in the bitmap is modified 
as follows: 

• An incoming data bit results in no change. 

• An incoming data bit 1 results in the current data being exclusively or'ed (XOR) with the 
appropriate Foreground bit. If the Foreground bit is 0, the current data is unchanged. If the 
Foreground bit is 1, the current data is complemented by binary inversion. In effect, the 
Foreground Register acts as a plane select register for the complement operation. 
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When the logic unit is operating in OVERLAY mode, the current data in the bitmap is modified as 
follows: 

• An incoming data bit results in no change. 

• An incoming data bit 1 results in the current data being replaced by the appropriate Foreground 
bit. 

NOTE 

Do not change the contents of the ALU/PS Register before the GDC has 
completed all pending write operations. If you do, the information that is in 
the process of being displayed will take on the new characteristics of the 
ALU/PS Register. 

Color Mop 

The Color Map is a 16 X 16-bit RAM area where each of the 16 entries is composed of four 4-bit 
values representing color intensities. These values represent, from high order to low order, the 
monochrome, blue, red, and green outputs to the video monitor. Intensity values are specified in 
inverse logic. At one extreme, a value of zero represents maximum intensity (100% output) for a 
particular color or monochrome shade. At the other extreme, a value of OFh represents minimum 
intensity (zero output). 

Bitmap data is not directly displayed on the monitor, each bitmap plane contributes one bit to an 
index into the Color Map. The output of the Color Map is the data that is passed to the monitor. 
Four bitmap planes (medium resolution) provide four bits to form an index allowing up to 16 intensi- 
ties of color or monochrome to be simultaneously displayed on the monitor. Two bitmap planes (high 
resolution) provide two bits to form an index allowing only four intensities of color or monochrome to 
be simultaneously displayed on the monitor. 



4-9 



Graphics Option Components 



In Figure 11, a medium resolution configuration, the bitmap data for the display point x,y is 0110b. 
This value, when applied as an index into the Color Map, selects the seventh entry out of a possible 
sixteen. Each Color Map entry is sixteen bits wide. Four of the bits are used to drive the color 
monitor's red gun, four go to the green gun, four go to the blue gun, and four drive the output to 
the monochrome monitor. The twelve bits going to the color monitor support a color palette of 4096 
colors; the four bits to the monochrome monitor support 16 shades. (In systems with the Model 100- 
A motherboard, only the two low-order bits of the monochrome output are active. This limits the 
monochrome output to four unique intensities.) 
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Figure 1 1. Bitmap/Color Map Interaction (medium resolution) 
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In Figure 12, a high resolution configuration, the bitmap data for point (x,y) is 10b. This value, when 
applied as an index into the Color Map, selects the third entry out of a possible four. Again, each 
Color Map entry is sixteen bits wide; 12 bits of information are used for color and four are used for 
monochrome. (In systems with the Model 100-A motherboard, only the two low-order bits of the 
monochrome output are active. This limits the monochrome output to four unique intensities.) 
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Figure 12. Bitmap/Color Map Interaction (high resolution) 
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Loading the Color Map 

The Graphics Option accesses the Color Map as sixteen 16-bit words. However, the CPU accesses 
the Color Map as 32 eight-bit bytes. The 32 bytes of intensity values are loaded into the Color Map 
one entire column of 16 bytes at a time. The red and green values are always loaded first, then the 
monochrome and blue values. (See Figure 13.) 
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Figure 13. Sample Color Map With Loading Sequence 
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Writing the value DFh to port 53h selects the Color Map and also clears the Color Map Index 
Counter to zero. To load data into the Color Map requires writing to port 51h. Each write to port 
51h will cause whatever is on the motherboard data bus to be loaded into the current Color Map 
location. After each write, the Color Map Index Counter is incremented by one. If 33 writes are 
made to the Color Map, the first Color Map location will be overwritten. 

NOTE 

Do not change the contents of the Color Map before the GDC has com- 
pleted all pending write operations. If you do, the information that is in the 
process of being displayed will take on the new Color Map characteristics. 

Video Drive Voltages 

The output of the Color Map, as shown in Figures 11 and 12, consists of four 4-bit values that 
represent the red, green, blue, and monochrome intensities to be displayed on some applicable 
monitor. These four intensity values are the input to four digital-to-analog converters. (Refer to the 
block diagram in Appendix B.) The output of these converters are the video drive voltages that are 
applied to pins 9 through 12 of the J3 Video Output Jack. 

The output of the digital-to-analog converters for the red, green, and blue intensities is not depen- 
dent on the model of the system motherboard. The digital-to-analog converter for the monochrome 
intensities, however, produces different output depending on whether the motherboard is a model A 
or a model B. On systems with a model A motherboard, only the two low-order bits of the intensity 
value are active. This provides a limited range of only four output voltages for the monochrome 
signal. On a color monitor only configuration, where the green output is derived from the mono- 
chrome portion of the Color Map, the same limited range appUes. On systems with a model B 
motherboard, all four bits of the intensity value are active. This provides the full range of 16 output 
voltages for the red, green, blue, and monochrome signals. The conversion of Color Map intensity 
values to video drive voltages for each of these ranges are shown in Table 2. 

The perceived intensity of a display is not linearly related to the video drive voltages. A given 
difference in drive voltage at the high end of the range is not as noticeable as the same difference 
occurring at the low end of the range. 
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Table 2. Intensity Values vs Video Drive Voltages 



INTENSITY VALUES 


VIDEO DRIVE VOLTAGES (NORMALIZED) 


HEX 


BINARY 


LIMITED RANGE 


FULL RANGE 





0000 


1.09 


1.00 


1 


0001 


0.79 


0.85 


2 


0010 


0.71 


0.79 


3 


0011 


0.09 


0.73 


4 


0100 


1.09 


0.67 


5 


0101 


0.79 


0.61 


6 


01 10 


0.71 


0.55 


7 


01 1 1 


0.09 


0.49 


8 


1000 


1.09 


0.43 


9 


1001 


0.79 


0.38 


A 


1010 


0.71 


0.31 


B 


1011 


0.09 


0.26 


C 


1 100 


1.09 


0.21 


D 


1 101 


0.79 


0.12 


E 


1 110 


0.71 


0.07 


F 


1111 


0.09 


0.00 


LIMITED RANGE: MODEL A — ALL MONOCHROME OUTPUT 






— GREEN OUTPUTON COLOR 






MONITOR ONLY SYSTEM 


FULL RANGE: MODEL A — RED/BLUE OUTPUT ON COLOR 






MONITOR ONLY SYSTEM 






— RED/GREEN/BLUE OUTPUT ON 






DUAL MONITOR SYSTEM 




MODEL B — RED/BLUE/GREEN/MONOCHROME 






OUTPUT ON ALL SYSTEMS 
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Mode Register 

The Mode Register is an 8-bit multi-purpose register that is loaded by first selecting it with a write 
of BFh to port 53h and then writing a data byte to port 51h. The bits in the Mode Register have the 
following functions: 

• Bit determines the resolution mode: 

= medium resolution mode (384 pixels across) 

1 = high resolution mode (800 pixels across) 

• Bit 1 determines the write mode: 

= word mode, 16 bits/RMW cycle, data from Write Buffer 

1 = vector mode, 1 bit/RMW cycle, data from Pattern Generator 

• Bits 3 and 2 select a bitmap plane for readback mode operation: 

00 = plane 

01 = plane 1 

10 = plane 2 

11 = plane 3 

• Bit 4 determines the option's mode of operation: 

= read mode, bits 3 and 2 determine readback plane 

1 = write mode, writes to the bitmap allowed but not mandatory 

• Bit 5 controls writing to the Scroll Map: 

= writing is enabled (after selection by the Indirect Register) 

1 = writing is disabled 

• Bit 6 controls the interrupts to the CPU generated by the Graphics Option every time the GDC 
issues a vertical sync pulse: 

= interrupts are disabled, any pending interrupts are cleared 

1 = interrupts are enabled 

• Bit 7 controls the video data output from the option: 

= output is disabled, other option operations still take place 

1 = output is enabled 

NOTE 

Do not change the contents of the Mode Register before the GDC has 
completed all pending write operations. If you do, the functions controlled 
by the Mode Register will take on the new characteristics and the results 
may be indeterminate. 
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Scroll Map 

The Scroll Map is a 256 X 8-bit recirculating ring buffer that is used to offset scan line addresses in 
the bitmap in order to provide full and split-screen vertical scrolling. The entire address as generated 
by the GDC does not go directly to the bitmap. Only the low-order six bits of the GDC address go 
directly to the bitmap. They represent one of the 64 word addresses that are the equivalent of one 
scan line in high resolution mode or two scan lines in medium resolution mode. The eight high-order 
bits of the GDC address represent a line address and are used as an index into the 256-byte Scroll 
Map. The eight bits at the selected location then become the new eight high-order bits of the 
address that the bitmap sees. (See Figure 14.) By manipulating the contents of the Scroll Map, you 
can perform quick dynamic relocations of the bitmap data in 64-word blocks. 
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Figure 14. Scroll Map Operation 
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Loading the Scroll Mop 

Start loading the offset addresses into the Scroll Map at the beginning of a vertical retrace. First set 
bit 5 of the Mode Register to zero to enable the Scroll Map for writing. Write a 7Fh to port 53h to 
select the Scroll Map and clear the Scroll Map Index Counter to zero. Then do a series of writes to 
port 51h with the offset values to be stored in the Scroll Map. Loading always begins at location zero 
of the Scroll Map. With each write, the Scroll Map Index Counter is automatically incremented until 
the write operations terminate. If there are more than 256 writes, the index counter loops back to 
Scroll Map location zero. This also means that if line 255 requires a change, lines 0-254 will have to 
be rewritten first. 

All 256 scroll map entries should be defined even if all 256 addresses are not displayed. This is to 
avoid mapping undesirable data onto the screen. After the last write operation, bit 5 of the Mode 
Register should be set to one to disable further writing to the Scroll Map. 

The time spent to load the Scroll Map should be kept as short as possible. During loading, the GDC's 
address lines no longer have a path to the bitmap and therefore memory refresh is not taking place. 
Delaying memory refresh can result in lost data. 

While it is possible to read out of the Scroll Map, time constraints preclude doing both a read and a 
rewrite during the same vertical retrace period. If necessary, a shadow image of the Scroll Map can 
be kept in some area in memory. The shadow image can be updated at any time and then trans- 
ferred into the Scroll Map during a vertical retrace. 
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Initialization and Control 



The examples in this chapter cover the initialization of the Graphics Display Controller (GDC) and 
the Graphics Option, the control of the graphics output, and the management of the option's color 
palette. 



Test for Option Present 

Before starting any appHcation, you should ensure that the Graphics Option has been installed on the 
Rainbow system. Attempting to use the Graphics Option when it is not installed can result in a 
system reset that can in turn result in the loss of appUcation data. The following code will test for 
the option's presence. 



Example of Option Test 

procedure option-present-test * 

* 

purpose: test if Graphics Option is present. * 

entry: none. * 

exit: dl = 1 option present. * 

dl=0 option notpresent. * 

register usage: ax,dx * 
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cseg 


segment 


byte 


publ i c 


' codesg ' 








publ i c 


opt i on- 


pr esen t- 


test 








as sume 


es : cseg 


,ds:nothing,es:nothi 


ng , ss : nothing 




option 


-present- 


test 


pr oc 


near 








mov 


dl , 1 




;set dl for 


option present 






in 


al ,8 




; i npu t from 


port 8 






test 


al , 04h 




;test bit 2 


to see if option 


present 






opt 1 




; i f option 


i s present , exit 






xor 


dl ,dl 




; e 1 s e , set 


dl for option not 


present 


op 1 1 : 


ret 












option 


-present- 


test 


endp 









cseg 



ends 
end 



Test for Motherboard Version 

When you initially load or subsequently modify the Color Map, it is necessary to know what version 
of the motherboard is installed in the Rainbow system. The code to determine this is operating 
system dependent. The examples in the following sections are written for CP/M, MS-DOS, and 
Concurrent CP/M. 



Example of Version Test for CP/M System 



procedure test_board_version * 

«■ 

purpose: Test motherboard version * 

restriction: This routine will work under cp/m only. * 

entry: none. * 

exit: flag J= = 'A' motherboard * 

1 = 'B' motherboard * 

register usage: ax , bx , cx , dx , di , s i , es * 
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dseg 






flag 


db 


OOOh 




buffer 


r 5 


14 


;reserve 14 bytes 




cseg 






tes t_board_ver 5 ion : 






push 


bp 






IDOV 


ax ) d 5 


;clear buffer, Just to be sure 








;point es:di at it 




mov 


di , 






inov 


CX , 1 *t 


;14 bytes to clear 






al , al 


;clear clearing byte 


nnt 1 • 
op L 1 ■ 


mov 


hii -F-fcknTrlil al 


;do the clear 




1 T) c 


di 








op 1 1 


• 

jloop till done 




fnov 


ax y d 5 


;point bp:dx at buffer for 




mov 


bp , ax 


; inl 4U call 




mov 


dx, offset buffer 






mov 


di , 1ah 


;set opcode for call to get hw ^ 




int 


40 






mov 


si , 






mov 


cx,8 


;set count for possible return ASCII 


opt2: 


cmp 


buf f er [ si ] , 






j^e 


opts 


;got something back, have rainbow 'B' 




inc 


s 1 






loop 


opt2 


; loop till done 




mov 


f lag,0 


;no ASCII, set rainbow 'A' type 




j"^P 


opt4 




opt3: 


mov 


flag, 1 


;got ASCII, set rainbow 'B' type 


opt4: 


pop 


bp 






ret 







Example of Version Test for MS-DOS System 



procedure test_board_version * 

* 

purpose: test motherboard version * 

restriction: this routine will work under MS-DOS only * 

entry: none * 

exit: flag :* « 'A' motherboard * 

1 * 'B' motherboard * 

register usage: ax , bx , cx , dx , di , s i * 
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caeg 


segment 


byte 


publ ic 


'codesg' 






publ Ic 


test-board- vers ion 






assume 


cs : cseg 


,ds:dseg, 


es:dseg,ss:nothing 




test. 


.board-version 


proc 


near 






push 


bp 




; save bp 






mov 


di ,0 




; clear buffer to 


be sure 




mov 


cx, 14 




;14 bytes to clear 




xor 


al ,al 




;clear clearing 


byte 


tb1 : 


mov 


byte pt 


r buf f er C di 3 , al ;do the clear 






inc 


di 










loop 


tb1 




;loop till done 






mov 


ax , ds 




;point bp:dx at 


buffer for 




mov 


bp , ax 




; int 18h call 






mov 


dx, offset buffer 








mov 


di , 1ah 




;set opcode for call to 


get hw ' 




int 


18h 




;int 40 remapped to 18h 


under MS-DOS 




mov 


si,0 










mov 


cx,8 




jset count for possible 


return ASCI I 


tb2: 


cmp 


byte pt 


r bufferCsi],0 








tb3 




;got something back, have rainbow 'B' 




inc 


s i 










1 oop 


tb2 










mov 


f lag,0 




;no ASCII, set rainbow ' 


A' type 






tb4 








tb3: 


mov 


flag, 1 




;got ASCII, set rainbow 


B type 


tb4: 


pop 


bp 




; recover bp 






ret 










test- 


.board-version 


endp 






cseg 


ends 










dseg 


segment 


byte 


publ ic 


'datasg' 






publ i c 


flag 








flag 


db 











buffer db 


14 


dup (?) 







dseg 



ends 
end 
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Example of Version Test for Concurrent CP/M System 



««««*««««*«««««««**««««•«««*«««««««*««««««••*««*•««•««•««««*«*««««•« 



; p r o c 


edure test-b 


oard-version 


; purpose: 


test motherboard 


version 


; restriction: this routine for 


Concurrent CP/M only 


; entry: 


none 




; exit: 


flag :- 


- 'A' motherboard 

1 « 'B' motherboard 


; register 


usage: ax , bx , cx , dx , s i 




.«««««««««««««•**»«««■»««»**««««««**«««««««*«««««««*««««««««««*«*«««• 


tes t«board_ver s ion : 




mov 


cont rol_b+2 , ds 




mov 


di, offset biosd 




mov 


bx,3 




mov 


[di-^bx] ,ds 




mov 


dx, offset biosd 


;setup for function 50 call 


mov 


cl,32h 




int 


OeOh 


;function 50 


mov 


flag, 


;set flag for rainbow 'A' 


mov 


bx,6 


;offset to array- 14 


mov 


si, offset array-14 




mov 


al,'0' 




cmp 


C si-i-bx] ,al 


;'0', could be a rainbow 'A' 




found_b 


;no, must be rainbow 'B' 


inc 


bx 


; next number . . . 


mov 


al,'1' 


; can be e i ther 1 . . . 


cmp 


[si+bx],al 




]e 


test -boa rd-exit 




mov 


al,'2' 


;or 2 . . . 


cmp 


Csi-*-bx] ,al 




]e 


tes t -board-ex i t 




mov 


al,'3' 


;or 3 if its a rainbow 'A' 


cmp 


[ si+bx] ,al 






tes t-board-exi t 
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f ound_b : 

mov flag, 1 

te5t_board_exit : 
ret 
d5eg 

biosd db 
dw 
dw 

control_b dw 
dw 
dw 

array_14 rs 
flag db 
end 



; i t 5 a rai nbow 'B' 



80h 

offset control_b 



4 



offset array_14 

14 





Initialize the Graphics Option 

Initializing the Graphics Option can be separated into the following three major steps: 

• Reset the GDC to the desired display environment. 

• Initialize the rest of the GDC's operating parameters. 

• Initialize the Graphic Option's registers, buffers, and maps. 

Reset the GDC 

To reset the GDC, give the RESET command with the appropriate parameters followed by com- 
mands and parameters to set the initial environment. The RESET command is given by writing a 
zero byte to port 57h. The reset command parameters are written to port 56h. 

The GDC Reset Command parameters are the following: 

Parameter Value Meaning 

1 12h The GDC is in graphics mode 

Video display is noninterlaced 
No refresh cycles by the GDC 
Drawing permitted only during retrace 

2 16h For medium resolution 
30h For high resolution 

The number of active words per line, less two. There are 24 (18h) active 
words per line in medium resolution mode and 50 (32h) words per line in 
high resolution mode. 
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Parameter Value Meaning 

3 61h For medium resolution 
64h For high resolution 

The low-order five bits are the horizontal sync width in words less one 
(medium res. HS=2, high res. HS=5). The high-order three bits are the 
low-order three bits of the vertical sync width in lines (VS=3). 

4 04h For medium resolution 
08h For high resolution 

The low-order two bits are the high-order two bits of the vertical sync 
width in lines. The high-order six bits are the horizontal front porch 
width in words less one (medium res. HFP=2, high res. HFP=3). 

5 02h For medium resolution 
03h For high resolution 

Horizontal back porch width in words less one (medium res. HBP=3, high 
res. HBP=4). 

6 03h Vertical front porch width in lines (VFP=3). 

7 FOh Number of active lines per video field (single field, 240 line display). 

8 40h The low-order two bits are the high-order two bits of the number of 

active lines per video field. The high-order six bits are the vertical back 
porch width in lines (VBP=16). 



Initialize the GDC 

Now that the GDC has been reset and the video display has been defined, you can issue the rest of 
the initialization commands and associated parameters by writing to ports 57h and 56h respectively. 

Start the GDC by issuing the START command (6Bh). 

ZOOM must be defined; however, since there is no hardware support for the Zoom feature, program 
a zoom magnification factor of one by issuing the ZOOM command (46h) with a parameter byte of 
00. 

Issue the WD AT command (22h) to define the type of Read/Modify/ Write operations as word trans- 
fers - low byte, then high byte. No parameters are needed at this time because the GDC is not being 
asked to do a write operation; it is only being told how to relate to the memory. 
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Issue the PITCH command (47h) with a parameter byte of 20h for medium resolution or 40h for 
high resolution to tell the GDC that each scan line begins 32 words after the previous one for 
medium resolution and 64 words after the previous one for high resolution. Note, however, that only 
24 or 50 words are displayed on each screen line. The undisplayed words left unscanned are 
unusable. 

The GDC can simultaneously display up to four windows. The PRAM command defines the window 
display starting address in words and its length in lines. The Graphics Option uses only one display 
window with a starting address of 0000 and a length of 256 lines. To set this up, issue the PRAM 
command (70h) with four parameter bytes of 00,00,FO,OF. 

Another function of the GDC's parameter RAM is to hold soft character fonts and line patterns to be 
drawn into the bitmap. The Graphics Option, rather than using the PRAM for this purpose, uses the 
external Character RAM and Pattern Generator. For the external hardware to work properly, the 
PRAM command bytes 9 and 10 must be loaded with all ones. Issue the PRAM command (78h) with 
two parameter bytes of FF,FF. 

Issue the CCHAR command (4Bh) with three parameter bytes of 00,00,00, to define the cursor 
characteristics as being a non-displayed point, one Hne high. 

Issue the VSYNC command (6Fh) to make the GDC operate in master sync mode. 

Issue the SYNC command (OFh) to start the video refresh action. 

The GDC is now initialized. 

Initialize the Graphics Option 

First you must synchronize the Graphics Option with the GDC's write cycles. Reset the Mode 
Register by writing anything to port 50h and then load the Mode Register. 

Next, load the Scroll Map. Wait for the start of a vertical retrace, enable Scroll Map addressing, 
select the Scroll Map, and load it with data. 

Initialize the Color Map with default data kept in a shadow area. The Color Map is a write-only area 
and using a shadow area makes the changing of the color palette more convenient. 

Set the Pattern Generator to all ones in the Pattern Register and all ones in the Pattern Multiplier. 

Set the Foreground/Background Register to all ones in the foreground and all zeros in the 
background. 

Set the ALU/PS Register to enable all four planes and put the option in REPLACE mode. 

Finally, clear the screen by setting the entire bitmap to zeros. ,^ 
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Example of Initializing the Graphics Option 

The following example is a routine that will initialize the Graphics Option including the GDC. This 
initialization procedure leaves the bitmap cleared to zeros and enabled for writing but with graphics 
output turned off. Use the procedure in the next section to turn the graphics output on. Updating of 
the bitmap is independent of whether the graphics output is on or off. 



; p r o c 


e d u r 


e init_option 


* 
* 


; purpose : 




initialize the graphics option 


* 
* 


; entry: 




dx = 1 medium resolution 
dx = 2 high resolution 


* 
* 


; e X i t : 




all shadow bytes initialized 


* 


; register 


usage : 


none, all registers are saved 


* 


. ######*****####•»*##*#* 


********************************************** 


cseg segment 


byte 


pub 1 i c ' codesg ' 




extrn a 1 ups : near , pa t t 


ern_regi5ter:near,pattern_mult:near,fgbg 


near 


pub 1 i c 


ini t-op t ion 




assume 


cs : cseg 


,ds:dseg,es:dseg,ss:nothing 




ini t_opt ion 


pr oc 


near 




push 


ax 


;save the registers 




push 


bx 






push 


cx 






push 


dx 






push 


di 






push 


s i 






eld 




jmake sure that stos incs. 





First we have to find out what the interrupt vector is for the 
graphics option. If this is a Model 100-A, interrupt vector 
22h is the graphics interrupt. If this is a Model 100-B, the 
interrupt vector is relocated up to A2. If EE00:0F44h and 
04<>0, we have the relocated vectors of a Model 100-B and need 
to OR the msb of our vector. 



mov 


ax , ds 






mov 


word ptr cs 


segment -save , ax 


push 


es 


; save 


va 1 i d es 


mov 


bx , OeeOOh 


; test 


if vectors are relocated 


mov 


es , bx 






mov 


ax,88h 




■100-A int. vector base addr 


test 


es : by t e ptr 


Of 44h,4 


;relocated vectors? 




go 




; jump if yes 


mov 


ax,288h 




;100-B int. vector base addr 
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m i d - r e 5 : 



mov 


word ptr 


g_int_ 


ve c , ax 




DO D 


es 








cmp 


dx, 1 




^medium resolution? 




i z 
J 


mid-res 




: i umD if ve s 




J "r 


h i _r es 




;else is high resolution 




fnov 


al ,00 




^medium resolution reset command 




oat 


B7h,al 








mov 


gbmod,030h 


;mode = med res, text, no readback 




call 


mode 




; turn off graphics output 




mov 


al , 12h 




5p1. refresh, draw enabled during 




out 


056h,al 




5 retrace 




mov 


al , 16h 




•p2, 24 words/line minus 2 




out 


056h,al 




;384/16 p i xe 1 s / wo r d = 24 words/line 




mov 


al ,61h 




; p3 . 3 bits vs/B bits hs width - 1 




out 


056h,al 




; vs=3, h5=2 




mov 


al ,04 




;p4. 6 bits hfp-1, 2 bits vs high 




out 


056h,al 




jbyte, 2 words hfp, no vs high byt 




mov 


al ,02 




5p5. hbp-1, 3 words hbp 




out 


056h,al 








mov 


al ,03 




^p6. vertical front porch, 3 lines 




out 


056h,al 








mov 


al , Of Oh 




;p7. active lines displayed 




out 


056h,al 








mov 


al ,40h 




;p8. 6 bits vbp/2 bits lines/field 




out 


056h,al 




;high byte, vbp=16 lines 




mov 


al ,047h 




;pitch command, med res, straight 


up 


out 


057h,al 








mov 


al ,32 




;med res memory width for vert, pi 


tch 


out 


056h,al 








mov 


word ptr 


nmr i 1 1 , 3f f f h 




mov 


word ptr 


xmax,383 ;384 pixels across in med 


res 


mov 


byte ptr 


num_p 1 


anes,4 ;4 planes in med res 




mov 


by t e ptr 


shifts 


_per_line,5 ;rotate5 for 32 wds/line 


mov 


byte ptr 


words- 


per_line,32 jwords in a line 






common_i ni t 
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h i-res : mov 


al ,00 




;high resolution reset command 


out 


57h,al 






mov 


gbmod , 03 1 h 


;mode = high res, text, no readback 


call 


mode 




;disable graphics output 


mov 


al , 12h 




;p1. refresh, draw enabled during 


out 


056h,al 




; r e t race 


mov 


al ,30h 




;p2. 50 words/line - 2 


out 


056h,al 






mov 


al ,64h 




;p3. hsync w-1=4(low 5 bits), vsync 


out 


056h,al 




;w=3(upper three bits) 


mov 


al , 08 




;p4. hor fp w-1=2(upper 2 bits), 


out 


056h,al 




;vsync high byte = 


mov 


al , 03 




;p5. hbp-1. 3 words hbp 


out 


056h,al 






mov 


al , 03 




;p6. vertical front porch, 3 lines 


out 


056h,al 






mov 


al , Of Oh 




;p7. active lines displayed 


out 


056h,al 






mov 


al ,40h 




;p8. 6 bits vbp/2 bits lines per field 


out 


056h , al 




;high byte. vbp=16 lines 


mov 


al , 047h 




;pitch command, high res, straight up 


out 


057h,al 






mov 


al ,64 




,'high res pitch is 64 words/line 


out 


056h,al 






mov 


word ptr 


nmrit 1 ,7f f f h 


mov 


word ptr 


xmax,799 ;800 pixels across 


mov 


byte ptr 


num_p 1 


anes,2 ;2 planes in high res 


mov 


byte ptr 


shifts 


-per_line,6 ;shifts for 64 wds/line 


mov 


byte ptr 


words- 


per_line,64 ;number of words/line 


common- i nit: 








mov 


al , 00 




;setup start window display for memory 


mov 


startl ,al 




;locationOO 


mov 


5 tar t h , a 1 






mov 


al , 06bh 




; start command 


ou t 


057h,al 




;start the video signals going 


mov 


al , 046h 




; zoom command 


out 


057h,al 






mov 


al , 




;magni f icat ion assumed to be 


out 


056h,al 






mov 


al ,22h 




;setup R/M/W memory cycles for 


out 


B7h,al 




; f i gur e dr awi ng 
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Initialize PRAM command. Start window at the address in startl, 
starth. Set the window length for 256 lines. Fill PRAM parameters 
8 and 9 with all ones so GDC can do graphics draw commands without 
altering the data we want drawn. 



mov 


al , 070h 


; issue the pram command, setup 


out 


057h,al 


;GDC display 


mov 


al , 5 t ar 1 1 


;p1. display window starting address 


out 


056h,al 


; 1 ow by t e 


mov 


al , starth 


;p2. display window starting address 


out 


056h,al 


;high byte 


mov 


al ,0f fh 


;p3. make window 256 lines 


out 


056h,al 




mov 


al ,Ofh 


;p4. high nibble display line on 


out 


056h,al 


; r i gh t , the rest = 


mov 


al , 078h 


;issue pram command pointing to p8 


out 


057h,al 




mov 


al,Offh 


;fill pram with ones pattern 


out 


056h,al 




out 


056h,al 




mov 


al ,04bh 


; issue the cchar command 


out 


057h,al 




xor 


a 1 , a 1 


^initialize cchar parameter bytes 


mov 


cchp 1 , al 


;graphic5 cursor is one line, not 


out 


056h,al 


;displayed, non-blinking 


mov 


cchp2 , al 




out 


056h,al 




mov 


cchp3 , al 




out 


056h,al 




mov 


al ,06fh 


;vsync command 


out 


057h,al 




out 


050h,al 


; reset the graphics board 


mov 


al ,Obfh 




out 


53h,al 




mov 


aljbyte ptr 


gbmod ;enable, then disable interrupts 


or 


al ,40h 


5to flush the interrupt hardware 


out 


51h,al 


; latches 


mov 


cx,4920 


;wait for a vert sync to happen 
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loop 








mov 


al , Obf h 


;disable the interrupts 




out 


B3h,al 






mov 


aljbyte ptr gbmod 






oat 


51h,al 






call 


a55ert_colormap 


load CO 1 ormap 




call 


i n5 c r 1 


; initialize scroll map 




mov 


bl , 1 


',5et pattern multiplier to 16-bl 




call 


pat t er n_mu 1 1 


;see example "pattern-mult" 




mov 


bl , Of f h 


;set pattern data of all bits set 




call 


pattern_regi5ter 


,"5ee example "pat ter n_regi s ter" 




mov 


bl , Of Oh 


;enable all foreground registers 




call 




;see example "fgbg" 




mov 


bl ,0 


;enable planes 0-3, REPLACE logic 




call 


a 1 ups 


jsee example "alups" 




mov 


di , offset p 1 


;filJ the p table with ff's. 




mov 


al , Of f h 






mov 


cx , 1 6 






rep 


5 t05b 






mov 


al,0 


;enable all gb mask writes. 




mov 


gbms k 1 , al 






mov 


gbms k h , a 1 






mov 


al ,0f fh 


jset GDC mask bits 




mov 


gdcml , al 






mov 


gdcmh , a 1 






mov 


word ptr cur 10,0 


; set cursor to top screen left 




mov 


ax, word ptr gbmskl 


;fetch and issue the graphics 




out 


54h,al 


; op t i on text mas k 




mov 


a 1 , ah 






out 


55h,al 






call 


set ram 


5 then set ram to p1 thru p16 data 




mov 


word ptr ymax,239 






mov 


al , Odh 






out 


57h,al 


;enable the display 




pop 


5 i 


;recover the registers 




pop 


di 






pop 


dx 






pop 


cx 






pop 


bx 






pop 


ax 






ret 






i n i t_ 


option 


endp 
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,«••«•#«««•«««««««««««#«««««••«««««•«•*•«««««««•«•««««««*«««««««««««« 
> • * 

9 ^ 



phlca subroutines 



.«•««•«««««#««•««««««««»«*««««•«««*«**««•*«««««««***«»«««««*•«««««««* 



gaubs proc near 

publ ic set ram, assert -CO lor map , gdc.no t. busy , Imode ,color-int,scrol-lnt 
public cxy2cp,mode 

•*«*#««««««**««•«»«««*«««««««*««««««««««««»«*««««««»*«*»««««»»««•«*« 

subroutine assert.colormap * 

colormap is located at clmpda which is defined in * 
procedure "change_colormap" * 

entry: clmpda ■ colormap to be loaded * 

exit: none * 

register usage: ax,bx * 
«««««««*«««««««««««««««»««««*««««*««««««#«#««««*«»»««««««««»*««««««* 

asser t.col ormap : 
eld 

call gdc. not-busy ;mal(e sure nothing's happening 

The graphics interrupt vector "giv" is going to be either 22h or 
A2h depending on whether this is a Model 100-A or a Model 100-B 
with relocated vectors. Read the old vector, save it, then 
overwrite it with the new vector. 



push 


es 




xor 


ax , ax 




mov 


es , ax 




mov 


bx,word ptr g-int-vec 


;fetch address of "giv" 


cli 




;temp. disable interrupts 


mov 


ax , es : [ bx ] 


;read the old offset 


mov 


word ptr old-int_of f , ax 




mov 


ax , es : Cbx+2] 


;read the old segment 


mov 


word ptr old-int.seg , ax 




mov 


word ptr es : [ bx ] , of f se t 


color-int ;load new offset 


mov 


ax , cs 




mov 


es : [bx-*-2] ,ax 


;load new int segment 


sti 




;re-enable interrupts 


pop 


es 




mov 


byte ptr int_done,0 


;clear interrupt flag 


or 


byte ptr gbmod,40h 


;enable graphics interrupt 


call 


mode 
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col or_i 



test 


byte ptr 


int-done , Of f h ;has interrupt routine run? 




ac 1 




push 


es 


;restore interrupt vectors 


xor 


ax , ax 




mov 


es ,ax 




mov 


bx , word 


ptr g_int-vec ;fetch graphics vector offset 


Gil 






mov 


ax , word 


ptr old_int-off ;restore old interrupt vector 


mov 


es: [bx] , 


ax 


mov 


ax , word 


ptr old_int»seg 


mov 


es : [bx+2] ,ax 


six 






pop 


es 




eld 




;make lods inc si 


ret 






Hi 






push 


es 




push 


ds 




push 


si 




push 


cx 




push 


ax 




mov 


ax , word 


ptr cs : segment-save ;can't depend on es or ds 


mov 


ds , ax 


;reload segment registers 


mov 


es , ax 




c 1 a 








byte ptr 


gbmod,Obfh ;disable graphics interrupts* 


nst 1 1 
Call 


mode 




mov 


si, offset clmpda ;fetch color source 


mov 


al ,Odfh 


;get the color map's attention 


ou I 


053h,al 




mov 


cx,32 


; 32 color map entries 


lodsb 




;fetch current color map data 


out 


051h,al 


; load color map 


1 oop 


cil 


;loop until all color map data loaded 


mov 


byte ptr 


int_done , Of f h ;set "interrupt done" flag 


pop 


ax 




pop 


cx 




pop 


s i 




pop 


ds 




pop 


es 




iret 







5-15 



Initialization and Control 



subroutine cxy2cp * 

CXY2CP takes the xinit and yinit numbers, converts them to * 

an absolute memory location and puts that location into * 

curio, 1,2. yinit is multiplied by the number of words per * 

line. The lower 4 bits of xinit are shifted to the left * 

four places and put into curl2. xinit is shifted right four * 

places to get rid of pixel information and then added to * 

yinit times words per line. This result becomes curlO, * 

cur 1 1 . * 

# 

entry: xinit = x pixel location * 

yinit = y pixel location * 

exit: curio, 1,2 * 

register usage: ax,bx,cx,dx * 



cxy2cp : mov 


c 1 , by t e 


ptr sh i f t s-per- 1 i ne 


mov 


ax , y ini t 


;compute yinit t imes words / 1 i ne 


shl 


ax , c 1 


;ax has yinit times words/line 


mov 


bx , X i n i t 


;calculate the pixel address 


mov 


dx , bx 


; save a copy of xinit 


mov 


cl ,4 


;5hift xinit 4 places to the left 


shl 


bl ,cl 


;bl has pixel within word address 


mov 


curl2,bl 


;pixel within word address 


mov 


cl ,4 


jshift xinit 4 places to right 


shr 


dx , c 1 


;to get xinit words 


add 


ax , dx 




mov 


word ptr 


curio, ax ;word address 


ret 







subroutine gdc-not_busy * 

gdc_not_busy will put a harmless command into the GDC and * 

wait for the command to be read out of the command FIFO. * 

This means that the GDC is not busy doing a write or read * 

operation. * 

entry: none * 

exit: none * 

register usage: ax * 
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gdc_not_bu5y: 





push 


cx 


use cx as a time-out loop counter 




i Ti 


al , 056h 


first check if the FIFO is full 




test 


al ,2 






jz 


gnb2 


jump if not 




mov 


cx ,8000h 


wait for FIFO not full or reasonable 


gnbO : 


i n 


al ,056h 


time, whichever happens first 




test 


al ,2 


has a slot opened up yet? 




jz 


gnb2 


jump if yes 




1 oop 


gnbO 


if loop count exceeded, go on anyway 


gnb2: 


mov 


al , Odh 


issue a screen-on command to GDC 




out 


057h,al 






i n 


al , 056h 


did that last command fill it? 




test 


al ,2 






jz 


gnb4 


jump if not 




mov 


cx,8000h 




grib3 : 


i n 


al , 056h 


read status register 




test 


al,2 


test FIFO full bit 






gnb4 


jump if FIFO not full 




loop 


gnb3 


loop until FIFO not full or give up 


gTib4 : 


mov 


ax,40dh 


issue another screen-on. 




out 


057h,al 


wait for FIFO empty 




mov 


cx,8000h 




gnbB : 


i n 


al,056h 


read the GDC status 




test 


ah , a 1 


FIFO empty bit set? 






gnbG 


j ump if not. 




loop 


gnb5 




gnbG : 


pop 


cx 






ret 







; subroutine imode * 

« 

; issue Mode command with the parameters from register gbmod * 

; entry: gbmod * 

; exit: none * 

; register usage: ax * 

imode: call gdc_not_busy 

mov al,Obfh ^address the mode register through 

out 53h,al ;the indirect register 

mov a 1 , gbmod 

out 51h,al ;load the mode register 

ret 
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mode: mov al,Obfh 
out 53h,al 
mov al , gbmod 

out 51h,al 
ret 

«««•«««««*#««*««**«««•««««**«*«•««««*«««««•«*«««««««*«*«««««*«««*««« 



;addres9 the mode register through 
;the indirect register 

;load the mode register 



subroutine inscrl 
initialize the scroll map 



entry : 
exi t : 



none 
none 



« 

register usage: ax , bx , cx , dx , di , s i * 
*««««««««««««««««*««««#«««««««««««*««««•««•«««««««««*«»««««««««*»»«« 



inscrl : eld 
mov 
xor 
mov 

inscO: stosb 
i nc 
1 oop 



cx,256 ;initialize all 256 locations of the 

al,al ;shadow area to desired values 

di, offset scrltb 

al 

inscO 



;The graphics interrupt vector is going to be either 22h or A2h 
;depending on whether this is a Model 100-A or a Model 100-B with 
;relocated vectors. Read the old vector, save it, and overwrite it 
;with the new vector. Before we call the interrupt, we need to 
;make sure that the GDC is not writing something out to the bitmap. 



ascrol : cal 1 
push 



xor 
mov 
mov 
cli 
mov 
mov 
mov 
mov 
mov 
mov 
mov 
sti 
pop 
mov 
or 

call 



gdc.no t.busy ;checl( if GDC id busy 

es 

ax , ax 
es , ax 

bx,word ptr g«int_vec 

;temporarily disable interrupts 
ax,es:[bx] ;read the old offset 

word ptr old-.int_of f , ax 

ax , es : [ bx-^2 ] ;read the old segment 

word ptr old.int.seg ,ax 

word ptr es : C bx 3 , of f se t scrol-.int ;load new offset 
ax,cs 

;load new interrupt segment 
;re-enable interrupts 



es : Cbx+2] ,ax 



byte ptr int_done,0 
byte ptr gbmod, 40h 
mode 



;clear interrupt flag 
;enable graphics interrupt 
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teat 


byte ptr i nt_done , Of f h ;has interrupt routine run? 


jz 


asl 


push 


es ;restore the interrupt vectors 


xor 


ax y ax 


mov 


es , ax 


mov 


bx,word ptr g-int_vec ;fetch graphics vector offset 


cli 




mov 


ax, word ptr old_int_off ;restore old interrupt vector 


mov 


es : [ bx ] , ax 


mov 


ax, word ptr old_int-seg 


mov 


es : [bx-*-2] ,ax 


sti 




pop 


es 


ret 





;Scrollmap loading during interrupt routine. 

;Fetch the current mode byte and enable scroll map addressing. 
5crol_int : 



push 


es 






push 


ds 






push 


si 






push 


dx 






push 


cx 






push 


ax 






eld 








mov 


ax, word ptr cs : segment-save jcan't depend 


on ds 


mov 


ds , ax 


;reload it 




mov 


es , ax 






and 


byte ptr gbmod,Obfh 'jdisable graphics interrupts 


mov 


al , gbmod 


;prepare to access scroll 


map 


mov 


gtemp 1 , al 


;first save current gbmod 




and 


gbmod , Odf h 


;enable writing to scroll 


map 


call 


mode 


;do it 




mov 


al ,07fh 


;select scroll map and reset scroll 


out 


53h,al 


;map address counter 




mov 


dl ,51h 


;output port destination 




xor 


dh,dh 






mov 


s i , of f se t scr 1 tb 


;first line's high byte 


addressee 


mov 


cx , 16 


;256 lines to write to 




test 


byte ptr gbmod , 1 


;high resolution? 






ins1 


; jump i f yes 




shr 


cx , 1 


;only 128 lines if medium 


resolut ion 
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1 odsw 






; fetch two scroll map locations 


out 


dx, 


al 


jassert the even byte 


mov 


al, 


ah 




out 


dx, 


al 


;assert the odd byte 


1 odsw 






;fetch two scrollmap locations 


out 


dx, 


al 


jassert the even byte 


mov 




ah 




out 


dx, 


al 


;assert the odd byte 


1 odsw 






;fetch two scrollmap locations 


out 


dx, 


al 


;as5ert the even byte 


mov 


al, 


ah 




out 


dx, 


al 


;assert the odd byte 


1 odsw 






;fetch two scrollmap locations 


out 


dx. 


al 


;assert the even byte 


mov 


al, 


ah 




out 


dx. 


al 


;assert the odd byte 


1 odsw 






;fetch two scrollmap locations 


out 


dx. 


al 


;assert the even byte 


mov 


al, 


ah 




out 


dx. 


al 


;a55ert the odd byte 


1 odsw 






;fetch two scrollmap locations 


out 


dx. 


al 


;assert the even byte 


mov 


al, 


ah 




out 


dx. 


al 


;assert the odd byte 


1 odsw 






;fetch two scrollmap locations 


out 


dx. 


al 


;assert the even byte 


mov 


al. 


ah 




out 


dx. 


al 


;assert the odd byte 


1 odsw 






;fetch two scrollmap locations 


out 


dx. 


al 


;assert the even byte 


mov 


al. 


ah 




out 


dx. 


al 


;assert the odd byte 


loop 


i HE 


i1 




mov 


a 1 , g t emp 1 


;restore previous mode register 


mov 


gbmod , a 1 




call 


mode 




mov 


byt 


;e pt r int 


_done,Offh ;set inter rupt -done flag 


pop 


ax 






pop 


cx 






pop 


dx 






pop 


5 i 






pop 


ds 






pop 


es 






i re t 






; return from interrupt 
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» 

subroutine setram * 

set video ram to a value stored in the p table * 

entry: 16 byte p1 table * 

exit: none * 

register usage: ax , bx , cx , dx , d i , s i * 



mov 


byte ptr 


twdir,2 ;5et write direction to the right 


call 


gdc_no t_ 


busy 


;make sure that the GDC isn't busy 


mov 


al ,Ofeh 




;select the write buffer 


out 


053h,al 






out 


051h,al 




;reset the write buffer counter 


mov 


si, offset p1 


;initialize si to start of data 


mov 


cx, 10h 




;load 16 chars into write buffer 


lodsb 






;fetch byte to go to write buffer 


out 


52h,al 






loop 


setr 1 






mov 


al ,Ofeh 




; sel ec t the write buffer 


out 


053h,al 






out 


051h,al 




;re5et the write buffer counter 


mov 


al ,049h 




; issue GDC cursor location command 


out 


57h,al 






mov 


a 1 , by t e 


ptr 


curio ;fetch word 1 oca t ion 1 ow byte 


out 


56h,al 




; load parame t er 


mov 


a 1 , by t e 


ptr 


cur 1 1 ; f e t ch wor d 1 oca t ion high by t e 


out 


56h,al 




; load parame t er 


mov 


a 1 , 4ah 




; set the GDC mask to all F's 


out 


57h,al 






mov 


al ,0f fh 






out 


56h,al 






out 


56h,al 






mov 


al , 04ch 




;issue figs command 


out 


57h,al 






mov 


al , byte 


ptr 


twdir ^direction to write. 


out 


56h,al 






mov 


a 1 , nmr i 1 1 


; number of GDC writes, 1 ow byte 


out 


56h,al 






mov 


a 1 , nmr i t h 


; number of GDC writes, high byte 


out 


56h,al 






mov 


al ,22h 




;wdat command 


out 


57h,al 






mov 


al ,0f fh 




; p 1 and p2 are dummy parameter s 


out 


56h,al 




; the GDC requires them for internal 


out 


56h,al 




; pur poses - no effect on the outside 


ret 
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segmen t_5ave dw ;d5 save area for interrupts 

gsubs endp 

cseg ends 
dseg segment byte public 'datasg' 
extrn clmpda:byte 
public xmax ,ymax , alu , d , d 1 , d2 , dc 

public curio, curl1 ,curl2,dir,fg,gbm5kl,gbmskh, gbmod , gdcml , gdcmh 
public nmredl ,nmredh,nmritl ,nmrith,p1 ,prdata,prmult,scrltb,startl 
public gtemp3,gtemp4,5tarth,gtemp,gtemp1 , g t emp2 ,twdir,xinit,xfinal 
public yinit,yfinal,a5crol, num_p lanes , shifts -.per_line 
public words_per_l ine , g_int_vec 



;variables to 


be remembered about the graphics board states 


alu 


db 





current ALU state 




cchp 1 


db 





cursor/character 




cchp2 


db 





size def i ni t i on 




cchp3 


db 





parameter bytes 




curio 


db 





cursor - low byte 




cur 1 1 


db 





location - middle byte 




cur 12 


db 





storage - high bits & 


dot address 


dc 


dw 





figs command dc parameter 




d 


dw 





figs command d parameter 




d2 


dw 





figs command d2 parameter 




d1 


dw 





figs command d1 parameter 




di r 


db 





figs direction. 




fg 


db 





current foreground register 




gbms k 1 


db 





graphics board mask register 


- low byte 


gbms k h 


db 







- high byte 


gbmod 


db 





graphics board mode register 




gdcm 1 


db 





GDC mask register bits - low 


byte 


gdcmh 


db 





- high 


byte 
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g_int_vec 


dw 





^graphics option's interrupt vector 


g t emp 


dw 







;temporary storage 


gt emp 1 


db 







^temporary storage 


g t emp2 


db 







; temporary storage 


g t emp3 


db 







^temporary storage 


gt emp4 


db 







;temporary storage 


i n t -done 


db 





; i n t e r r u p t - d o n e state 


nmred 1 


db 







number of read operations - low byte 


nmredh 


db 







- high byte 


nmr i 1 1 


db 







number of GDC writes - low byte 


nmr i t h 


db 







- high byte 


num_p lanes 


db 





number of planes in current resolution 


o 1 d_ i Ti t 


_5eg 


dw 





old interrupt segment 


o 1 d_ i n t 


>of f 


dw 





old interrupt offset 


pi 


db 


16 


dup C?) 


;shadow write buffer & GDC parameters 


prda ta 


db 







pattern register data 


prmu 1 t 


db 







pattern register multiplier factor 


scr 1 tb 


db 


100h dup (?) jscroll map shadow area 


5 i_ t emp 


dw 









5 tar 1 1 


db 







register for start address of display 


5 tar t h 


db 









t wd i r 


db 





;directioTi for text mode write operatioi 


shif t5_ 


per _ 1 i ne 


db 





shift factor for one line of words 


word5_per_line 


db 


; words/scan line for current resolution 


X i ni t 


dw 







X initial position 


yini t 


dw 







y initial position 


xf i na 1 


dw 







X final position 


y f i na 1 


dw 







y final position 


xmax 


dw 









ymax 


dw 










dseg ends 
end 
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Controlling Graphics Output 

There will be occasions when you will want to control the graphics output to the monitors. The 
procedure varies according to the monitor configuration. The following two examples illustrate how 
graphics output can be turned on and off in a single monitor system. The same procedures can be 
used to turn graphics output on and off in a dual monitor system. However, in a dual monitor 
configuration, you may want to display graphics output only on the color monitor and continue to 
display VT102 VSS text output on the monochrome monitor. This can be accomplished by loading an 
83h into OAh instead of an 87h. 



Example of Enabling a Single Monitor 



» 

procedure graphic5_on * 

# 

purpose: enable graphics output on single * 

color monitor * 

* 

entry: gbmod contains mode register shadow byte * 

exit: none * 

register usage: ax * 



dseg 


segmen t by t e 


pub 1 i c 


' da tasg ' 


ex t r n 


gbmod : by t e 


; defined 


in procedure ' i n i t -op t i on ' 


dseg 


ends 






cseg 


segment byte 


pub 1 i c 


' codesg ' 


ext rn 


imode : near 


; def i ned 


in procedure ' ini t_opt ion' 




pub 1 i c gr aph i c s_on 






as sume c s : c seg 


, ds : dseg , 


es:dseg,s5 :nothing 



graphics-on proc near 

mov a 1 , 87h 

out Oah,al ;enable graphics on monochrome line 

or byte ptr gbmod, 080h ;enable graphics output in gbmod 

call imode jassert new mode register 

ret ; 

graphics_on endp 

cseg ends 
end 
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Example of Disabling a Single Monitor 



* 



; proc 


e d u 


re graphic5_off 


* 


; purpose: 




disable graphics output to single 


♦ 






(color) mon i tor 


* 


; entry: 




gbmod contains mode register shadow byte 


♦ 


; exit: 




none 


* 


; register 


usage 


: ax 


* 




dseg segment 


byte 


public 'datasg' 




extrn gbmod:by 


te 


;defined in procedure ' i n i t _opt i on ' 




dseg ends 








cseg segment 


byte 


pub 1 i c ' codesg ' 




extrn imode:near 


jdefined in procedure ' i n i t _op t i on ' 




pub 1 i c 


graphi 


CS-Off 




as sume 


cs : cse 


g,ds:dseg,e5:d5eg,ss:nothing 




gr aph i c s_of f 


proc 


near 




and 


byte p 


tr gbmod, 07fh jdisable graphics output in g 


bmod 


call 


imode 


jassert new mode register 




mov 


al ,83h 






ou t 


Oah ,al 


;turn off graphics on monochrome 


line 


ret 








graphi cs_of f 


endp 






cseg ends 








end 









Modifying and Loading the Color Map 

For an application to modify the Color Map, it must first select the Color Map by way of the Indirect 
Register (write DFh to port 53h). This will also clear the Color Map Index Counter to zero so 
loading always starts at the beginning of the map. 

Loading the Color Map is done during vertical retrace so there will be no interference with the 
normal refreshing of the bitmap. To ensure that there is sufficient time to load the Color Map, you 
must catch the beginning of a vertical retrace. First, check for vertical retrace going inactive (bit 5 
of the GDC Status Register = 0). Then, look for the vertical retrace to start again (bit 5 of the GDC 
Status Register = 1). 
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To modify only an entry or two, the use of a shadow color map is suggested. Changes can first be 
made an5rwhere in the shadow map and then the entire shadow map can be loaded into the Color 
Map. The next section is an example of modifying a shadow color map and then loading the data 
from the shadow map into the Color Map. 



Example of Modifying and Loading Color Data in a 
Shadow Map 

«««#««*»«*«*«•»««««««««««««»«««««•««««««««««««■««»•*«««■«««««*«««■#««««« 

procedure chang e c olormap * 

« 

purpose: change a color in the colormap * 

entry: ax * new color (0 " highest intensity) * 

(F * lowest intensity) * 

al « high nibble " red data * 

low nibble " green data * 

ah « high nibble « gi^ay data * 

low nibble « blue data * 

bx « palette entry number * 

« 

exit: none * 

register usage: ax,bx,si * 

»««#«««*«»«»««»«««»**«*«««**««««««««««**«««««**«««««»»««««««******«« 

cseg segment byte public 'codesg' 

extrn assert-colormap : near ;defined in ' ini t-opt ion' 
public change-co 1 ormap 

assume cs:c5eg,d5:dseg,es:dseg,S5: no thing 

? 

change. colormap proc near 

mov si, offset clmpda ;colormap shadow 

mov Csi-*-bx],al ;store the red and green data 

add bx,16 ;increment to gray and blue data 

mov Csi+bx],ah ;store the gray and blue data 

call assert. colormap ;defined in ' ini t.opt ion' 

change-colormap endp 

cseg ends 

dseg segment byte public 'datasg' 
public clmpda 
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Co 1 ormaps : 

Information in the Color Map is stored as 16 bytes of red and 
green data followed by 16 bytes of monochrome and blue data. 
For each color entry, a specifies full intensity and Ofh 
specifies zero intensity. 

A sample set of color map entries for a Model 100-B system with 
a monochrome monitor in medium resolution (16 shades) would look 
as follows in the shadow area labelled CLMPDA: 
no red or green data 



c Impda 



db 


Of f h 




db 


Of f h 




db 


Of f h 




db 


Of f h 




db 


Of f h 




db 


Of f h 




db 


Of f h 




db 


Of f h 




db 


Of f h 




db 


Of f h 




db 


Of f h 




db 


Of f h 




db 


Of f h 




db 


Of f h 




db 


Of fh 




db 


Of fh 




3me 


data , no blue 


data 


db 


Of fh 


black 


db 


OOfh 


white 


db 


Olfh 




db 


02fh 




db 


03fh 


light monochrome 


db 


04fh 




db 


05fh 




db 


06fh 




db 


07fh 


medium monochrome 


db 


08fh 




db 


09fh 




db 


Oafh 




db 


Obfh 


dark monochrome 


db 


Ocfh 




db 


Odfh 




db 


Oefh 
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On a Model 100-A system, only the lower two bits of the monochrome 
nibble are significant. This allows only four monochrome shades 
as opposed to 16 shades on the Model 100-B system in medium 
resolution mode. The following sample set of data applies to both 
the Model 100-A monochrome-only system in either medium or high 
resolution mode, as well as the Model 100-B monochrome-only system 
in high resolution mode. 



; no red or green data 



c Impda 



db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 



Of f h 
Of fh 
Of f h 
Of f h 
Of f h 
Of fh 
Of f h 
Of f h 
Of f h 
Of fh 
Of fh 
Of fh 
Of f h 
Of fh 
Of f h 
Of f h 



^monochrome data, no blue data 



db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 



Of fh 
OOf h 
05f h 
Oaf h 
Of f h 
Of f h 
Of fh 
Of f h 
Of fh 
Of f h 
Of f h 
Of f h 
Of fh 
Of f h 
Of f h 
Of f h 



black 
whi te 

light monochrome 

dark monochrome 

black 

black 

black 

black 

black 

black 

black 

black 

black 

black 

black 

black 
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In a dual monitor configuration, with a Model 100-B system in 
medium resolution mode, all four components of each color entry 
are present: red, green, blue and monochrome. A sample set of 
color data would be as follows: 



c Impda 



;red and green data 



db 


Of fh 


db 


OOOh 


db 


Of Oh 


db 


OOfh 


db 


OOOh 


db 


OOfh 


db 


Of fh 


db 


Of Oh 


db 


Oaah 


db 


OfSh 


db 


08fh 


db 


088h 


db 


OOfh 


db 


Of fh 


db 


OfSh 


db 


077h 


>nochrome ai 


db 


Of fh 


db 


OOOh 


db 


010h 


db 


020h 


db 


03fh 


db 


04fh 


db 


050h 


db 


06fh 


db 


07ah 


db 


OfSh 


db 


098h 


db 


Oafh 


db 


Obfh 


db 


Oc8h 


db 


Odfh 


db 


Oe7h 



black 
white 
cyan 
magenta 
ye 1 low 
red 
blue 
green 
dk gray 
dk cyan 
dk magenta 
dk yellow 
dk red 
dk blue 
dk green 
gray 



black 
white 



light mono. 



med. mono. 



dark mono. 



black 
whi te 
cyan 
magenta 
yellow 
red 
blue 
green 
dk gray 
dk cyan 
dk magenta 
dk yellow 
dk red 
dk blue 
dk green 
gray 
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On a Model 100-A dual monitor configuration, in medium resolution 
mode, all 16 color entries are displayable. However, only two 
bits of monochrome data are available allowing for only 4 
monochrome shades. 

On a Model 100-A dual monitor configuration, in high resolution 
mode, there are four displayable colors and again, four monochrome 
shades . 

□n a Model 100-B dual monitor configuration, in high resolution 
mode, there also are four displayable colors and four monochrome 
shades . 

In a color monitor only system, the green data must be mapped 
to the monochrome output. For a Model 100-B single color monitor 
system, in medium resolution mode, a sample color map would be as 
shown below: 

NOTE 

The following sample color map will be 
assembled with this example. If this 
is not appropriate, substitute one of 
the other samples or generate one that 
is custom tailored to the application. 

;red data, green data mapped to mono. 



db 


Of fh 


black 


db 


OOfh 


whi te 


db 


Of fh 


cyan 


db 


OOfh 


magenta 


db 


OOfh 


yel low 


db 


OOfh 


red 


db 


Of fh 


blue 


db 


Of fh 


green 


db 


Oafh 


dk gray 


db 


Of fh 


dk cyan 


db 


08fh 


dk magenta 


db 


08fh 


dk yellow 


db 


08fh 


dk red 


db 


Of fh 


dk blue 


db 


Of fh 


,dk green 


db 


07fh 


;gray 
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green 


data, blue 


data 


db 


Of fh 


black 


db 


OOOh 


whi te 


db 


OOOh 


cyan 


db 


Of Oh 


magenta 


db 


OOfh 


yel low 


db 


Of fh 


red 


db 


Of Oh 


blue 


db 


OOfh 


green 


db 


Oaah 


dk gray 


db 


088h 


dk cyan 


db 


OfSh 


dk magenta 


db 


08fh 


dk yellow 


db 


Off h 


dk red 


db 


OfSh 


dk blue 


db 


08fh 


dk green 


db 


077h 


gray 



;For a Model 100-A single color monitor system, in either high or 
;medium resolution mode, only the lower two bits of the monochrome 
;output are significant. Therefore, you can only display four 
;intensities of green since the green data must be output through 
;the monochrome line. The same applies to a Model 100-B single 
;color monitor system in high resolution mode. 

dseg ends 
end 
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Bitmap Write Setup (General) 



Loading the ALU/PS Register 

The ALU/PS Register data determines which bitmap planes will be written to during a 
Read/Modify/Write (RMW) cycle and also sets the operation of the logic unit to one of three write 
modes. 

Bits through 3 enable or disable the appropriate planes and bits 4 and 5 set the writing mode to 
REPLACE, COMPLEMENT, or OVERLAY. Bits 6 and 7 are not used. Bit definitions for the 
ALU/PS Register are in Part III of this manual. 

Write an EFh to port 53h to select the ALU/PS Register and write the data to port 51h. 

Example of Loading the ALU/PS Register 

; procedure alups * 

; purpose: set the ALU/PS register ♦ 

; entry: bl = value to set ALU/PS register to * 

; exit: update ALU/PS shadow byte * 

; register usage: ax, * 
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dseg segment byte 

extrn alu:byte 

dseg ends 

cseg segment byte 



public 'datasg' 



public 'codesg' 



extrn gdc-no t-busy : near 
public alups 

assume cs:cseg,ds:dseg,es:dseg,ss:nothing 



alups 



alups 
cseg 



proc 

call 

mov 

out 

mov 

mov 

out 

ret 

endp 

ends 

end 



near 

gdc-not-busy 
al ,Oefh 
53h,al 

byte ptr alu,bl 

al,bl 

51h,al 



;defined in procedure ' ini t_opt ion' 
;select ALU/PS register 

;update shadow byte (alu) 

;move new ALU/PS value to al 

;load new value into ALU/PS register 



Loading the Foreground/Background Register 

The data byte in the Foreground/Background Register determines whether bits are set or cleared in 
each of the bitmap planes during a bitmap write (RMW) operation. Bit definitions for the Fore- 
ground/Background Register are in Part III of this manual. 

Write an F7h to port 53h to select the Foreground/Background Register and write the data byte to 
port 51h. 



Example of Loading the Foreground/Background Register 

* 

procedure fgbg * 

« 

purpose: set the foreground / background register * 

entry: bl = value to set fgbg register to * 

exit: update fgbg shadow byte * 

register usage: ax * 
##*»*«#*#»**#*#*#«#«#*#»#♦*»*»♦«#♦###»##♦♦*»*##♦#»«««♦###♦##»»#♦♦♦»* 
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dseg segment byte public 'datasg' 
extrn fgibyte 
dseg ends 

cseg segment byte public 'codesg' 

extrn gdc.no t.busy : near 

public '^gbg 

assume cs:cseg,ds:dseg,es:dseg,ss:nothing 



cseg 



proc 

call 

mov 

out 

mov 

mov 

out 

ret 

endp 

ends 

end 



near 

gdc-no t-busy 
al ,0f7h 
53h,al 

byte ptr fg,bl 

al ,bl 

51h,al 



defined in ' ini t«opt ion' 
select the foreground/background 
register 

update shadow byte with new value 
;load new value into fgbg register 
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This chapter contains examples that illustrate displaying 64K bytes of memory, and clearing a rec- 
tangular area of the screen to a given color. 

Display Data from Memory 

In the following example, video data in a 64K byte area of memory is loaded into the bitmap in order 
to display it on the monitor. The last byte of the memory area specifies the resolution to be used. A 
value of zero means use medium resolution mode. A value other than zero means use high resolution 
mode. In medium resolution mode, the 64K bytes are written to four planes in the bitmap; in high 
resolution mode, the 64K bytes are written to two planes. 

Example of Displaying Data from Memory 

; procedure ritvid * 

; purpose: restore a graphics screen save in a 64k * 

; segment of main memory by the procedure * 

; ritvid. * 
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dseg segment byte public 'datasg' 
ex t rn gbmod : by te , gtemp : wor d , num. planes :byte,curlO:byte, gtemp 1 : by tc 
dseg ends 

vidseg segment byte public 'vseg' 
extrn viddata:byte 
vidseg ends 

cseg segment byte public 'codesg' 
extrn ini t_opt ion : near , f gbg : near , gdcnot-busy :near,alups: near 
extrn imodeinear 

public ritvid 

assume cs:cseg,ds:dseg,es:dseg,ss:nothing 



ritvid proc near 

The video data is in vidseg. The last byte in vidseg is the 
resolution flag. If flag is*0 the option is in medium resolution 
mode; otherwise it is in high resolution mode. Initialize the 
option to that resolution. 



mov ax,es 

mov word ptr cs : segmen t_save , ax 



;save es 





call 


gdc_not_busy 


;wait till GDC is free 




mov 


ax , vidseg 


;set es to point to video buffer 




mov 


es > ax 






mov 


si ,0f f f fh 


;fetch the resolution flag from 




mov 


al , es : [ si ] 


; the last byte of vidbuf 




test 


al ,0f fh 


;is it high resolution? 




jnz 


rt1 


; jump if yes . 




mov 


dx, 1 








rt2 




rt1 : 


mov 


dx,2 




rt2: 


mov 


ax, word ptr cs 


: segment-save 




mov 


es , ax 


; restore old es 




call 


ini t-opt ion 


;assert the new resolution. 


; i ni t 


-option 


leaves us in text 


mode with fg«fO and alups^O. 




and 


byte ptr gbmod, Ofdh 




or 


byte ptr gbmod, 010h 




call 


imode 


;make sure we're in text mode 




mov 


bl,Ofh 


;put ^'s into bg and O's into fg 




call 




;because write buffer inverts data 




test 


byte ptr gbmod 


,1 ;high resolution? 






rt3 


;jump if yes. 




mov 


word ptr gtemp, 1024 ;8 wrd-wr i tes/plane (med res) 






rt4 




rt3: 


mov 


word ptr gtemp, 2048 ;8 wrd-wr i tes/plane (high res) 
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rt4: mov di,0 ;5tart at beginning of vidbuf. 

mov ax^vidseg ;set es to point to video buffer 

mov e5,ax 

mov cl,byte ptr num_plane5 ;fetch number of plane5 

xor ch,ch ; to be written 

•jEnable a plane to be written. 

rt5: mov word ptr gtemp1,cx ; save plane writing counter 

mov bl,byte ptr num-.plane5 ;5elect plane to write enable 

sub bl,cl ;this is plane to write enable 

mov c 1 , bl 

mov bljOfeh ;put a in that plane's select position 

r o 1 bl , c 1 

and bl,Ofh ;keep in REPLACE mode 

call alups ;assert the new ALU/PS 

;Fill that plane with data, 8 words at a time, from vidseg. 

mov word ptr curlO,0 ;5tart write at top left 

mov cx,word ptr gtemp ;number of 8 word writes 

rt6: push cx ; to fill plane 

call gdc_not-busy ;wait until GDC has finished 

mov al,Ofeh ; previous write 

out 53h,al 

out 5 1 h , al 

mov cx,16 ;fetch 16 bytes 

rt7: mov al,es:[di] ;fill ptable with data 

inc di ; to be written 

out 52h,al 

loop rt7 

mov al,49h ;assert the position to 

out 57h,al ; start the write 

mov ax, word ptr curlO 

out 56h,al 

mov al , ah 

out 56h,al 

mov al,04ah ;init the mask to Offffh 

out 57h,al 

mov al,Offh 

out 56h,al 

out 56h,al 

xor al , al 

out 54h,al 

out 55h,al 

mov al,4ch 

out 57h,al ;now start the write 

mov al,2 ;direction is down 
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out 


3on } a 1 










mov 


al , 7 








jdo 8 writes 


out 


56h , al 










X o r 


a 1 } a 1 










out 


56h al 










mov 


a 1 J cLcri 










out 


57h , al 










mov 


a 1 n -f -f h 

a 1 J u T T n 










out 


■^^Rh n 1 
3C7n 7 a X 










out 


56h , al 










add 


word ptr 


curio 


, 08 


;next location to be written 


pop 


cx 










loop 


rte 








;loop to complete this plane 


mov 


cx , wor d 


ptr 




emp 1 


;keep looping until all 


loop 


rt5 








; planes are written 


mov 


ax , wor d 


ptr 


cs 


: segmen t 


-Save 


mov 


es , ax 










ret 












endp 












-save 


dw 












cseg ends 
end 



Set a Rectangular Area to a Color 

The example that follows illustrates how to set a rectangular area of the screen to some specified 
color. Input data consists of the coordinates of the upper left and lower right corners of the area (in 
pixels) plus the color specification (a 4-bit index value). The special case of setting the entire screen 
to a specified color is included in the example as a subroutine that calls the general routine. 



Example of Setting a Rectangular Area to a Color 

procedure set_all_5creen * 

purpose: set entire screen to a user defined color * 

entry: di is the color to clear the screen to * 

exit: "fgbg aTid alups shadow bytes updated * 

register usage: ax , bx , cx , dx , s i , d i * 

cseg segment byte public 'codesg' 

extrn fgbg:near,gdc_not_busy:near,imode:near,alups:near 
public set-al l_5creen , 5et_rec tangle 
assume cs : cseg , ds : dseg ,es : nothing, ss : nothing 
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set 


_all 


-screen 


proc near 










mov 


word ptr xs tar t , 


; start at the top 


left corner 






mov 


word ptr ystart,0 










mov 


ax, word ptr xmax 










mov 


word ptr x5top,ax 


;fetch the bottom 


right corner 






mov 


ax, word ptr ymax 










mov 


word ptr ystop,ax 


; coordinates . 








j"^P 


set_rec tangle 






set 


-all 


-screen 


endp 












P ^ 


o c e d 


ure set_r 


ectangle 


« 
« 




pur 


pose : 


set a user defined 


screen rectangle to 


a * 








user defined color 




♦ 



entry : 



xs 


tart 


has 


the start x in pixels 


* 


ys 


tart 


has 


the start y in scan lines 




xs 


top 


has 


the stop X in pixels 


« 


ys 


top 


has 


the stop y in scan lines 




di 


i s 


the 


color to clear the screen to 


* 



exit: * 
register usage: ax , bx , cx , dx , d i , s i , xs t ar t is altered * 

#«###♦#*#####♦###♦#♦#•»♦♦#♦####*#*♦*###♦*#«*#♦###»#*#»#»#####♦«*♦# # * # 

set_rectangle proc near 

No validity checks are being made on start and stop coordinates. 

xstart must be <= xstop 
ystart must be < = ystop 

Assert the new screen color to both nibbles of the the foreground/ 
background register. Put the option into REPLACE mode with all 
planes enabled and in wr i t e-enab 1 ed word mode. 



mov 


bx,di 


;di has the color; only low nibble valid 


mov 


bh,bl 


;combine color number into both fg and bg 


mov 


cl ,4 


;shift the color up to the high nibble 


shl 


bh,cl 




or 


bl ,bh 


^combine high nibble with old low nibble 


call 




;assert new value to fgbg register 


xor 


bl ,bl 


;5et up REPLACE mode, all planes 


call 


al ups 


jassert new value to ALU/PS register 


and 


byte ptr 


gbmod,Ofdh ;set up text mode 


or 


byte ptr 


gbmod,10h jset up write enable mode 


call 


imode 


;assert new value to mode register 
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Do the rectangle write. 

Do the write one column at a time. Since the GDC is a word device, 
we have to take into account that we might have our write window 
start on a pixel that isn't on a word boundary. The graphics 
options write mask must be set accordingly. Do a write buffer 
write to all of the rectangle as defined by start, stop. Calculate 
the first curlO. Calculate the number of scans per column to be 
written. 



mov 


ax , word 


ptr xstart 


;turn pixel address into 


mov 


cl,4 




; word address 


shr 


ax , c 1 






mov 


dx , word 


ptr ystart 


;turn scan start to words/line*y 


mov 


c 1 , byte 


ptr shifts 


-per_line ;number of shifts 


shl 


dx , c 1 






add 


dx , ax 




;combine x and y word addresses 


mov 


word ptr 


curl , dx 


; first curio . 


mov 


ax , word 


ptr ystop 


;subtract start from stop. 


sub 


ax , word 


ptr ystart 




mov 


word ptr 


nmr i 1 1 , ax 





Program the text mask. 

There are four possible write conditions- 

a - partially write disabled to left 

b - completely write enabled 

c - partially disabled to the right 

d - partially disabled to both left and right 

The portion to be write disabled to the left will be the current 
xstart pixel information. As we write a column, we update the 
current xstart location. Only the first xstart will have a left 
hand portion write disabled. Orily the last will have a right 
hand portion disabled. If the first is also the last, a portion 
of both sides will be disabled. 



cls1: mov bx,Offffh ^calculate the current write mask 

mov cx,word ptr xstart 

and cx,Ofh ;eliminate all but pixel information 

shr bx,cl ;shift in a for each left pixel 

; to be disabled 



7-6 



Area Write Operations 



Write buffer write is done by columns. Take the current xstart 
and use it as the column to be written to. When the word address 
of xstart is greater than the word address of xstop, we are 
finished. There is a case where the current word address of 
xstop is equal to the current word address xstart. In that 
case we have to be concerned about write disabling the bits to 
the right. When xstop becomes less than xstart then we are done. 



mov 


ax, word ptr xstart 


;test if word xstop 


is equal 


and 


ax,Of f f Oh 


; to word xstart 




mov 


cxjword ptr xstop 






and 


cx,Of f f Oh 






cmp 


ax , cx 


; be 1 ow? 




jb 


clsS 


; j ump if yes 






cls2 


; j ump i f equa 1 - do 


last write 




exit 


;all done - exit 





We need to set up the right hand write disable. This is also the 
last write. bx has the left hand write enable mask in it. 
Preserve and combine with the right hand mask which will be 
(f-stop pixel address) bits on the right. 



cls2: mov cx,word ptr xstop 

and cx , f h 

i nc cx 

mov ax,Offffh 

shr axjcl 

xor ax,Offffh 

and bx,ax 



;strip pixel info out of xstop 

;make endpoint inclusive of write 
;shift the disable mask 
;wherever there is a one, we 
;want to enable writes 
;combine right and left masks 



bx currently has the mask bytes in it. Where we have a one, we 
want to make a zero so that particular bit will be write enabled. 



cls3: 



bx,Of ff fh 



;invert to get zeros for ones 



Assert the new write mask. Make sure that the GDC is not busy 
before we change the mask. 



cls4: call gdc_not-busy 

mov al , bh 

out 55h,al 

mov al , bl 

out 54h,al 



;check that the GDC isn't busy 
;assert the upper write mask 

;assert the lower write mask 



;Position the GDC at the top of the column to be written. This 
;addre5s was calculated earlier and the word need only be fetched 
;and applied. The number of scans to be written has already been 
; ca 1 cu la t ed . 
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mov al,49h ;a55ert the GDC cursor address 

out 57h , a 1 

mov ax, word ptr curlO jassert word address low byte 

out 56h,al 

mov aljdh jassert word address high byte 

out 56h,al 

;Start the write operation. Textmask, alups, gbmod and fgbg are 

;already set up. GDC is positioned. 

mov al,4ch ;assert figs to GDC 

out 57h,al 

xor al,al ^direction is down 

out 56h , a 1 

mov ax, word ptr nmritl 

out 56h,al ;a55ert number of write 

mov al,ah ; operations to perform 

out 56h,al 

mov al,22h ^assert wdat 

out 57h , a 1 

mov al , Of f h 

out 56h,al 

out 56h,al 

^Update the starting x coordinate for the start of the next 
;column write. Strip off the pixel information and then add 16 
;pixels to it to get the next word address. 

and word ptr x s t ar t , f f f Oh ;strip off pixel info 

add word ptr X5tart,16 ;address the next word 

i nc word ptr curlO 

jmp cls1 ;check for another column to clear 

exit: ret 
set-rec tangle endp 
cseg ends 

dseg segment byte public 'datasg' 
extrn curlOiword, gbmod : by te , xmax : wor d , ymax : wor d 
extrn shi f t 5_per_l ine : by te 
public xs tar t , xs t op , ys tar t , ys t op 
xstart dw 
xstop dw 
ystart dw 
ystop dw 
nmritl dw 
dseg ends 
end 
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The examples in this chapter illustrate some basic vector write operations. They cover setting up the 
Pattern Generator and drawing a single pixel, a line, and a circle. 

Setting Up the Pattern Generator 

When operating in Vector Mode, all incoming data originates from the Pattern Generator. The 
Pattern Generator is composed of a Pattern Register and a Pattern Multiplier. The Pattern Register 
supplies the bit pattern to be written. The Pattern Multiplier determines how many times each bit is 
sent to the bitmap write circuitry before being recirculated. 

NOTE 

The Pattern Multiplier must be loaded before loading the Pattern Register. 

Example of Loading the Pattern Register 

The Pattern Register is an 8-bit register that is loaded with a bit pattern. This bit pattern, modified 
by a repeat factor stored in the Pattern MultipHer, is the data sent to the bitmap write circuitry 
when the option is in Vector Mode. 



8-1 



Vector Write Operations 



procedure pattern-register * 

purpose: set the pattern register * 

» 

entry: bl = pattern data * 

exit: update pattern register shadow byte * 

register usage: ax * 

caution: you must set the pattern multiplier before * 

setting the pattern register * 

The pattern register contains a 16-bit pixel pattern that is written 
to the bitmap when the Graphics Option is in Vector Mode. 

Sample register values and corresponding patterns are: 

register value pattern output 



Of fh 
Oaah 
Of Oh 
Ocdh 



11111111 
10101010 
1 1 1 10000 
11001101 



The above assumes that the Pattern Multiplier has been set to 
multiply the pattern by 1. If the Pattern Multiplier had been set 
to multiply the pattern by 3, the above examples, when output to 
the bitmap would look as follows: 



register value 

Of fh 
Oaah 
Of Oh 
Ocdh 

dseg segment byte 
extrn prdata:byte 
dseg ends 
cseg segment byte 



pattern output 

111111111111111111111111 
1 1 10001 1 1000 1 1 10001 1 1 000 
1111111111 11000000000000 
1111 1100000011 1111000111 

public 'datasg' 



public 'codesg' 
extrn gdc_no t -busy : near 
public pattern-register 

assume cs:cseg,ds:dseg,es:d5eg,55:nothing 
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pa t t ern_reg i 5 t er proc near 

call gdc_not_bu5y "jdefined in ' ini t_opt ion' 
mov al,Ofbh ;5elect the pattern register 

out 53h,al 

mov byte ptr prdata,bl ;update shadow byte 

mov al , bl 

out 51h,al ;load the pattern register 

ret 

pattern-register endp 
cseg ends 
end 



Example of Loading the Pattern Multiplier 

The Graphics Option expects to find a value in the Pattern Multiplier such that sixteen minus that 
value is the number of times each bit in the Pattern Register is repeated. In the following example, 
you supply the actual repeat factor and the coding converts it to the correct value for the Graphics 
Option. 



procedur 


e pattern_mult 


« 


purpose : 


set the pattern multiplier 


* 


entry: 


bl = value to multiply pattern by (1 - 16) 


♦ 


exi t : 


updated pattern multiplier shadow byte 


» 


register usage: 


ax , bx 




cau t i on : 


you must set the pattern multiplier before 






setting the pattern register 


* 



«♦*«♦♦##»«*»♦♦♦###»♦♦«♦♦####«♦*##**♦»##**♦*♦♦#####«##♦###♦######*»#» 

segment byte public 'datasg' 
prmu 1 t : byte 
ends 

segment byte public 'codesg' 

extrn gdc_no t-busy : near ;defined in ' ini t_opt ion' 

public pattern_mult 

assume cs : cseg , ds : dseg , es : dseg , ss : nothi ng 



dseg 
extrn 
dseg 
cseg 
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pat t em_mu 1 1 
call 
mov 
dec 
not 



mov 
oat 
mov 
out 
ret 

pat t ern_mu 1 1 
C5eg ends 
end 



proc near 

gdc_not_bu5y ;defined in ' i n i t _op t i on ' 

byte ptr prmult,bl ;update multiplier shadow byte 



bl 
bl 



al , Of dh 
53h,al 
al ,bl 
51h,al 

endp 



;make bl zero relative 

;invert it - remember that pattern 

; register is multiplied by 16 minus 

;the multiplier value 

;select the pattern multiplier 

;load the pattern multiplier 



Display a Pixel 

The following example displays a single pixel at a location specified by a given set of x and y 
coordinates. Coordinate position 0,0 is in the upper left corner of the screen. The x and y values are 
in pixels and are positive and zero-based. VaUd values are: 

X = - 799 for high resolution 

- 383 for medium resolution 

y = - 239 for high or medium resolution 

Also, in the following example, it is assumed that the Mode, ALU/PS, and Foreground/Background 
registers have already been set up for a vector write operation. 

Example of Displaying a Single Pixel 



procedure pixel * 

purpose: draw a pixel * 

# 

entry: xinit = x location * 

yinit = y location * 
valid X values = 0-799 high resolution * 
= 0-383 medium resolution * 

valid y values = 0-239 med. or high res. * 

* 
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;Do a vector draw of one pixel at coordinates in xinit,yinit. Assume 
;that the Graphics Option is already set up in terms of Mode Register, 
; For eground/Bac k ground Register, and ALU/PS Register. 

dseg segment byte public 'datasg' 

extrn gbmod:byte,curlO:byte,curl1 :byte, curl2: byte, xinit: word 
extrn yinitrword 
dseg ends 

cseg segment byte public 'codesg' 

extrn cxy2cp:near,gdc_not_busy:near 
pub 1 i c pixel 

assume cs:cseg,ds:dseg,e5:dseg,ss:no thing 



pixel 



pr oc 


near 






call 


gdc_no t 


-busy 




call 


cxy2cp 




^convert x,y to a cursor position 


mov 


al ,49h 




;send out the cursor command byte 


out 


57h,al 






mov 


ax , word 


ptr 


curio -jBssert cursor location low byte 


out 


56h,al 






mov 


a 1 , ah 




^assert cursor location high byte 


out 


56h,al 






mov 


al , byte 


ptr 


curl2 ;assert cursor pixel location 


out 


56h,al 






mov 


a 1 , 4ch 




;assert the figs command 


out 


57h,al 






mov 


al ,02h 




;line direction - to the right 


out 


56h,al 






mov 


a 1 , 6ch 




;tell GDC to draw pixel when ready 


out 


57h,al 






ret 








endp 








ends 








end 









Display a Vector 

The example in this section will draw a line between two points specified by x and y coordinates 
given in pixels. The valid ranges for these coordinates are the same as specified for the previous 
example. Again it is assumed that the Mode, ALU/PS, and Foreground/Background registers have 
already been set up for a vector write operation. In addition, the Pattern Generator has been set up 
for the type of line to be drawn between the two points. 
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Example of Displaying a Vector 



« 

procedure vector * 

* 

purpose: draw a vector * 

«■ 

entry: xinit - starting x location * 

yinit = starting y location * 
xfinal= ending x location * 
yfinal= ending y location * 
valid X values = - 799 high resolution * 
- 383 medium resolution * 
valid y values = - 239 high or med. res. * 
exit: * 
register usage: ax * 

dseg segment byte public 'datasg' 

extrn curlO:byte,curl1 :byte,curl2:byte,dc:word,d:word,d2:word 
extrn d1 : wo rd,dir: byte, xinit: wo rd,yinit:word,xfinal:word 
extrn yfinal:word, gbmod :byte,p1 :byte 
dseg ends 

cseg segment byte public 'codesg' 
extrn gdc_not_busy:near, cxy2cp : near 
public vector 

assume cs : cseg , ds : dseg , es : dseg , ss : no thing 
vector proc near 

Draw a vec t or . 

Assume the start and stop coordinates to be in xinit, yinit, 
xfinal, and yfinal. The Foreground/Background, ALU/PS, Mode, 
and Pattern Registers as well as the GDC PRAM bytes and all other 
incidental requirements such as "gdc_not-busy" have been taken 
care of already. This routine positions the cursor, computes the 
draw direction, dc, d, d2, d1 and then implements the actual figs 
and figd commands. 

call gdc_not_busy 

call cxy2cp ;convert starting x,y to a cursor position 

mov al,49h ;set cursor location from curlO,1,2 

out 57h,al jissue the GDC cursor location command 

mov al, curio ;fetch word - low address 

out B6h,al 

mov al,curl1 ;fetch word - middle address 

out 56h,al 
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mov 


a 1 , cur 1 2 ; 


dot address (top 4 bits)/high address 




out 


56h,al 






mov 


ax, word ptr 


xinit ;start and stop points the same? 




cmp 


ax, word ptr 


xfinal ;jump if not 






v1 






mov 


ax, word ptr 


yinit ;might be - check the y's 




cmp 


ax, word ptr 


yf i nal 






v1 


; j ump if not 




mov 


al , 04ch ; wr i 


te single pixel - current vector write 




out 


057h,al ;car 


I't handle a one pixel write 




mov 


al ,2 






out 


056h,al 






mov 


al , 06ch 






out 


057h,al 






ret 






v1 : 


mov 


bx ,yf inal 


;compute delta y 




sub 


bx ,yini t 


;delta y negative now? 






quad34 


;jump if not (must be quad 3 or 4) 


quad12 : 


neg 


bx 


;delta y is negative, make absolute 




mov 


ax , xf i na 1 


;compute delta x 




sub 


ax , X i ni t 


;delta x negative? 




js 


quad2 


; j ump if yes 


quad 1 : 


cmp 


ax , bx 


;octant 2? 




jbe 


oct3 


; j ump if not 


oct2 : 


mov 


p1,02 


;direction of write 






vxind ; absCdel tax) >abs(del tay) , independent axis-x-axis 


oc 1 3 : 


mov 


p1 ,03 


;direction of write 






vyind ; absCdel tax>=<ab5Cdel tay) , independent axis=y-axis 


quad2 : 


neg 


ax 


;delta x is negative, make absolute 




cmp 


ax , bx 


;octant 4? 




jae 


oc 1 5 


; j ump i f no t 


oc 1 4 : 


mov 


p1,04 


^direction of write 






vyind ; absCdel tax)=<abs(del tay) , independent axis=y-axis 


oct5: 


mov 


p1 ,05 


;direction of write 






vxind ; absCdel tax)>abs(del tay) , independent axis=x-axis 


quad34 : 


mov 


ax , xf inal 


;compute delta x 




sub 


ax , xini t 








quad4 


;jump if delta x is positive 


quads : 


neg 


ax 


;make delta x absolute instead of negative 




cmp 


ax , bx 


joctant 6? 




jbe 


oc 1 7 


; J ump if not 


oc t6 : 


mov 


p1 ,06 


;direction of write 




i^p 


vxind jabsCdel tax)>abs(del tay) , independent axis^x-axis 


oc 1 7 : 


mov 


p1,07 


;direction of write 




i^p 


vyind ; abs ( de 1 tax) < =abs (de 1 tay ) , independent axis^y-axis 
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quad4: cmp ax,bx ;octant 0? 

jae oct1 ;jump if not 

octO: mov p1,0 ^direction of write 

jmp vyind ; absCdel tax)<ab5(del tay) , independent axis^y-axis 

oct1: mov p1,01 ;direction of write 

jmp vxind ; absCdel tax)=>(del tay> , independent axi5=x-axi5 

vyind: xchg ax,bx ;put independent axis in ax, dependent in bx 

vxind: and ax,03fffh ;limit to 14 bits 

mov dc,ax ; dc =ab5 C de 1 t a x) 

pu5h bx ; save absCdelta y) 

5hl bx,1 

sub bx,ax 

and bx,03fffh ;limit to 14 bits 

mov d,bx ; d=2*ab5(del ta y)-abs(delta x) 

pop bx ;restore(abs(deltay) 

push bx ; save absCdelta y) 

sub bx,ax 

shl bx,1 

and bx,03fffh ;limit to 14 bits 

mov d2,bx ; d2 = 2 * C ab s C de 1 t a y>-ab5Cdelta x)) 

pop bx 

shl bx,1 

dec bx 

and bx,03fffh ;limit to 14 bits 

mov d1,bx ;d1=2*abs(delta y)-1 

vdo: mov al,04ch ;issue the figs command 

out 57h , a 1 

mov al,08 ;construct pi of figs command 

or a 1 , p 1 

out 56h,al ;issue a parameter byte 

mov s i , of f set dc 

mov cx,08 ;issue the 8 bytes of dc,d,d2,d1 

vdol: lodsb ;fetch byte 

out 56h,al ;i55ue to the GDC 

loop vdol ;loop until all 8 done 

mov al,06ch ;start the drawing process in motion 

out 57h,al ; by issuing figd 

ret 

vector endp 
cseg ends 
end 
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Display a Circle 

The example in this section will display a circle, given the radius and the coordinates of the center in 
pixels. The code is valid only if the option is in medium resolution mode. If this code is executed in 
high resolution mode, the aspect ratio would cause the output to be generated as an eUipse. As in 
the previous examples, the option is assumed to have been set up for a vector write operation with 
the appropriate type of Hne programmed into the Pattern Generator. 



Example of Drawing a Circle 



procedure circle * 

purpose: draw a circle in medium resolution mode * 

# 

entry: xinit = circle center x coordinate (0-799) * 

yinit = circle center y coordinate C0-239> * 

radius = radius of the circle in pixels * 

# 

caution: This routine will only work in medium * 

resolution mode. Due to the aspect ratio * 
of high resolution mode, circles appear * 
as ell ipses . * 



Draw an circle. 

This routine positions the cursor, computes the draw direction, dc , 
d, d2, d1 and implements the actual figs and figd commands. 
The Mode Register has been set up for graphics operations, the write 
mode and planes select is set up in the ALU/PS Register, the 
Foreground/Background Register is loaded with the desired foreground 
and background colors and the Pattern Mul t ipl ier /Pat tern Register is 
loaded. In graphics mode, all incoming data comes from the Pattern 
Register. We have to make sure that the GDC's PRAM 8 and 9 are all 
ones so that it will try to write all ones to the bitmap. The 
external hardware intervene and put the pattern register's data 
into the bi tmap . 
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ex t rn 


gbmod :byte,curlO:byte,curl1 


: byte, curl2: by te,xinit: word 


ext rn 


yinit:word,dir:byte,5hift5« 


per_l ine : byte 


dseg 


segment 


byte public 'datasg' 






public 


radius , xad , yad 






dc 


dw 









d 


dw 









d2 


dw 









d1 


dw 









dm 


dw 









xad 


dw 









yad 


dw 









radius 


dw 









dseg 


ends 








cseg 


segment 


byte public 'codesg' 






ex t rn 


gdc_not_bu5y:near 








pub lie 


circle 








as sume 


cs:cseg,d5:dseg,es: 


dseg , ss 


: nothing 


circle 


□ roc 


near 








cal 1 


gdc_not_bu5y 








mov 


al ,78h 








out 


57h,al 


; set 


pram bytes 8 and 9 




mov 


al,Offh 








out 


56h,al 








out 


56h,al 








mov 


word ptr d1,-1 


; set 


figs d1 parameter 




mov 


word ptr dm,0 


; set 


figs d2 parameter 




mov 


bxjword ptr radius 


;get 


radius 




mov 


ax , Ob505h 


;get 


1/1.41 




i nc 


bx 








mu 1 


bx 








mov 


word ptr dc,dx 


;set 


figs dc parameter 




dec 


bx 








mov 


word ptr d,bx 


; s e t 


figs d parameter 




shl 


bx, 1 








mov 


word ptr d2,bx 


; set 


figs d2 parameter 




mov 


ax , word ptr xi ni t 


;get 


center x 




mov 


word ptr xad, ax 


; save 


it 




mov 


ax, word ptr yinit 


;get 


center y 




sub 


ax, word ptr radius 


;5ubtract radius 




mov 


word ptr yad, ax 


; save 


it 




call 


acvt 


;position cursor 




mov 


byte ptr di r , 1 h 


; arc 


1 




call 


avdo 


; draw 


it 




call 


acvt 


; pos i t i on cursor 




mov 


byte ptr dir,06h 


; arc 


6 




call 


avdo 


; draw 


it 
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mov 


ax , word ptr xinit 


;Qet center x 


mov 


word ptr xad,ax 


; save i t 


mov 


ax, word ptr yinit 


;get center y 


add 


ax, word ptr radius 


;add in radius 


mov 


word ptr yad,ax 


; save it 


call 


acvt 


; pos i t i on cursor 


mov 


byte ptr dir,02h 


;arc 2 


call 


avdo 


;draw it 


call 


acvt 


; pos i t i on cursor 


mov 


byte ptr dir,05h 


; a r c 5 


call 


avdo 


;draw it 



mov 


ax , word 


ptr xinit 


;get center x 


sub 


ax , word 


ptr radius 


; subtract 


radius 


mov 


word 


ptr 


xad , ax 


; save i t 




mov 


ax , word 


ptr yinit 


;get center y 


mov 


word 


ptr 


yad,ax 


;save it 




call 


acvt 






; pos i t i on 


cursor 


mov 


byte 


ptr 


di r , 03h 


; a r c 3 




call 


avdo 






;draw it 




call 


acvt 






; posi t ion 


cursor 


mov 


byte 


ptr 


dir , OOh 


; ar c 




call 


avdo 






;draw it 





mov 


ax , word ptr xinit 


get center x 


add 


ax, word ptr radius 


add in the radius 


mov 


word ptr xad , ax 


save it 


mov 


ax, word ptr yinit 


get center y 


mov 


word ptr yad , ax 


save it 


call 


acvt 


position cursor 


mov 


byte ptr dir,07h 


arc 7 


call 


avdo 


draw it 


call 


acvt 


position cursor 


mov 


byte ptr dir, 04h 


arc 4 


call 


avdo 


draw it 


ret 







Convert the starting x,y coordinate pair into a cursor position 
word value. 
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acvt ; 



avdo : 



avdo 1 ; 



circle 
cseg 



mov 
xor 
mov 
5hl 
mov 
mov 
mov 
d i V 
add 
mov 
mov 
mov 

5hl 

mov 

mov 

out 

mov 

out 

mov 

out 

mov 

out 

ret 

call 

mov 

out 

mov 

or 

out 

mov 

mov 

mov 

out 

i nc 

loop 

mov 

out 

ret 

endp 

ends 

end 



cljbyte ptr 
dx , dx 

ax , word ptr 
ax , c 1 
bx , ax 

ax , word ptr 

cx , 1 6 

cx 

ax , bx 
cur 1 , al 
cu r 1 1 , ah 
cl , 04 
dl ,cl 
cur 12,dl 
al ,49h 
57h,al 
a 1 , cu r 1 
56h,al 
a 1 , cur 1 1 
56h,al 
al , cur 12 
56h,al 



5hift5_per_line ;5et up for 32/16- bit 
;math - clear upper 16 bit 

yad 

;5ave lines * word/line 
xad jcompute number of words on last line 

; 16 bi t s/word 
;ax has number of extra words to add in 
;dx has the <16 dot address left over 
;this is the new cursor memory address 

;dot address is high nibble of byte 



;set cursor location to curlO,1,2 
;issue the GDC cursor location command 
; fetch word - low address 

;fetch word - middle address 

;dot address (top 4 bit5)/high address 



gdc_no t_busy 
al , 4ch 
57h,al 
al , 020h 

a 1 , by te ptr dir 
56h,al 

si, offset dc 
cx , 1 
al,[5i] 
56h,al 
s i 

avdo 1 
a 1 , 6ch 
57h,al 



tissue the figs command 

;con5truct p1 of figs command 

;issue a parameter byte 

;issue the 10 bytes of dc,d,d2,d1 

; fetch byte 

; i ssue to the GDC 

; point to next in list 

;loop until all 10 done 

;start drawing process in motion 

; by issuing f i gd 
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In this chapter the examples illustrate coding for writing byte-ahgned 8 X 10 characters, determin- 
ing type and position of the cursor, and writing bit-aligned vector (stroked) characters. 

Write a Byte-Aligned Character 

This example uses a character matrix that is eight pixels wide and ten scan lines high. The charac- 
ters are written in high resolution mode and are aligned on byte boundaries. The inputs are the 
column and row numbers that locate the character, the code for the character, and the color 
attribute. 

Example of Writing a Byte-Aligned Chiaracter 



procedure 



g t e X t 



* 



purpose : 



write 8 pixels wide x 10 scan lines 
graphics text in high resolution 



entry: 



ax is the column location of the character 
bx is the row location of the character 



dl is the character 
dh is the fgbg 



« 



dseg 



segment byte 



pub 1 i c 



' datasg ' 
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extrn cur 1 : by te , cur 12 : by te , gbmod : by te , f g : by te 

;Thi5 table has the addresses of the individual text font characters. 
jParticular textab addresses are found by taking the offset of the 
;textab, adding in the ASCII offset of the character to be printed 
;and loading the resulting word. This word is the address of the 
;start of the character's text font. 



gbmskl db 

gbmskh db 

textab dw 

dw 10 

dw 20 

dw 30 

dw 40 

dw 50 

dw 60 

dw 70 

dw 80 

dw 90 

dw 100 

dw 110 

dw 120 

dw 130 

dw 140 

dw 150 

dw 160 

dw 170 

dw 180 

dw 190 

dw 200 

dw 210 

dw 220 

dw 230 

dw 240 

dw 250 

dw 260 

dw 270 

dw 280 

dw 290 

dw 300 

dw 310 

dw 320 

dw 330 
dw ^ 340 

dw 350 

dw 360 

dw 370 
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dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 



380 
390 
400 
410 
420 
430 
440 
450 
460 
470 
480 
490 
500 
510 
520 
530 
540 
550 
560 
570 
580 
590 
600 
610 
620 
630 
640 
650 
660 
670 
680 
690 
700 
710 
720 
730 
740 
750 
760 
770 
780 
790 
800 
810 
820 
830 
840 
850 
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dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 
dw 

; t ex t font 

space db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

exclam db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

quote db 
db 
db 
db 
db 
db 
db 
db 
db 
db 



860 
870 
880 
890 
900 
910 
920 
930 
940 



11111111b 

Of f h 

Of f h 

Of f h 

Of f h 

Of fh 

Of f h 

Of fh 

Of f h 

11111111b 



11111111b 
11100111b 
11100111b 
11100111b 
11100111b 
11100111b 
11111111b 
11100111b 
11111111b 
11111111b 



11111111b 

Od7h 

Od7h 

Od7h 

Of fh 

Of f h 

Of f h 

Of f h 

Of f h 

11111111b 
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db 
db 
db 
db 
db 
db 
db 
db 
db 
db 



11111111b 
11010111b 
11010111b 
00000001b 
11010111b 
00000001b 
11010111b 
11010111b 
11111111b 
11111111b 



dollar 



db 
db 
db 
db 
db 
db 
db 
db 
db 
db 



11111111b 
11101111b 
10000001b 
01101111b 
1 00000 1 lb 
11101101b 
000000 1 lb 
11101111b 
11111111b 
11111111b 



percent db 
db 
db 
db 
db 
db 
db 
db 
db 
db 



11111111b 
00111101b 
00111011b 
11110111b 
11101111b 
11011111b 
10111001b 
01111001b 
11111111b 
11111111b 



amp 



db 
db 
db 
db 
db 
db 
db 
db 
db 
db 



11111111b 
10000111b 
011110 11b 
10110111b 
11001111b 
10110101b 
01111011b 
10000100b 
11111111b 
11111111b 



9-5 



Text Write Operations 



ape 



1 ef par 



r i t par 



aster 



db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

db 
db 
db 
db 
db 
db 
db 
db 
db 
db 



1111111b 
1100111b 
1101111b 
1011111b 
1111111b 
1111111b 
1111111b 
1111111b 
1111111b 
1111111b 

1111111b 
1 1 10011b 
1100111b 
1001111b 
1001111b 
1001111b 
1100111b 
1110011b 
1111111b 
1111111b 

1111111b 
1001111b 
1100111b 
1110011b 
1 1 10011b 
1110011b 
1100111b 
1001111b 
1111111b 
1111111b 

1111111b 
1111111b 
0111011b 
1010111b 
00000001b 
1010111b 
0111011b 
1111111b 
1111111b 
1111111b 
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plus 



period 



db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

db 
db 
db 
db 
db 
db 
db 
db 
db 
db 



1111111b 
1111111b 
1101111b 
1101111b 
00000001b 
1101111b 
1101111b 
1111111b 
1111111b 
1111111b 

1111111b 
1111111b 
1111111b 
1111111b 
1111111b 
1111111b 
1100111b 
1100111b 
1001111b 
1111111b 

1111111b 
1111111b 
1111111b 
1111111b 
00000001b 
1111111b 
1111111b 
1111111b 
1111111b 
1111111b 

1111111b 
1111111b 
1111111b 
1111111b 
1111111b 
1111111b 
1100111b 
1100111b 
1111111b 
1111111b 



9-7 



Text Write Operations 



slash db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

zero db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

one db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

two db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
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11111111b 
11111101b 
11111001b 
11110011b 
11100111b 
11001111b 
10011111b 
00111111b 
11111111b 
11111111b 

11111111b 
11000101b 
10010001b 
10010001b 
10001001b 
10001001b 
10011001b 
10100011b 
11111111b 
11111111b 

11111111b 
11100111b 
11000111b 
11100111b 
11100111b 
11100111b 
11100111b 
10000001b 
11111111b 
11111111b 

11111111b 
1 1000011b 
10011001b 
11111001b 
11100011b 
11001111b 
10011111b 
10000001b 
11111111b 
11111111b 
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three db 11111111b 

db 10000001b 

db 11110011b 

db 11100111b 

db 11000011b 

db 11111001b 

db 10011001b 

db 11000011b 

db 11111111b 

db 11111111b 

four db 11111111b 

db 11110001b 

db 11100001b 

db 11001001b 

db 10011001b 

db 10000001b 

db 11111001b 

db 11111001b 

db 11111111b 

db 11111111b 

five db 11111111b 

db 10000001b 

db 10011111b 

db 10000011b 

db 11111001b 

db 11111001b 

db 10011001b 

db 11000011b 

db 11111111b 

db 11111111b 

six db 11111111b 

db 11000011b 

db 10011001b 

db 10011111b 

db 10000011b 

db 10001001b 

db 10011001b 

db 11000011b 

db 11111111b 

db 11111111b 
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seven db 11111111b 

db 10000001b 

db 11111001b 

db 11110011b 

db 11100111b 

db 11001111b 

db 10011111b 

db 10011111b 

db 11111111b 

db 11111111b 

eight db 11111111b 

db 11000011b 

db 10011001b 

db 10011001b 

db 11000011b 

db 10011001b 

db 10011001b 

db 11000011b 

db 11111111b 

db 11111111b 

nine db 11111111b 

db 11000011b 

db 10011001b 

db 10010001b 

db 11000001b 

db 11111001b 

db 10011001b 

db 11000011b 

db 11111111b 

db 11111111b 

colon db 11111111b 

db 11111111b 

db 11111111b 

db 11100111b 

db 11100111b 

db 11111111b 

db 11100111b 

db 11100111b 

db 11111111b 

db 11111111b 
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Text Write Operations 



5colon db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

1 es 5 t db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

equal db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

greatr db 
db 
db 
db 
db 
db 
db 
db 
db 
db 



1111111b 
1111111b 
1111111b 
1100111b 
1100111b 
1111111b 
1100111b 
1100111b 
1001111b 
1111111b 

1111111b 
1111001b 
1110011b 
1001111b 
0011111b 
1001111b 
1110011b 
1111001b 
1111111b 
1111111b 

1111111b 
1111111b 
1111111b 
0000001b 
1111111b 
0000001b 
1111111b 
1111111b 
1111111b 
1111111b 

1111111b 
0011111b 
1001111b 
1110011b 
1111001b 
1110011b 
1001111b 
0011111b 
1111111b 
1111111b 
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Text Write Operations 



ques db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

at db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

capa db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

capb db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
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11111111b 
11000011b 
10011001b 
11111001b 
11110011b 
11100111b 
11111111b 
11100111b 
11111111b 
11111111b 

11111111b 
11000011b 
10011001b 
10011001b 
10010001b 
10010011b 
10011111b 
11000001b 
11111111b 
11111111b 

11111111b 
11100111b 
1 1 0000 1 1b 
10011001b 
10011001b 
10000001b 
10011001b 
10011001b 
11111111b 
11111111b 

11111111b 
10000011b 
10011001b 
10011001b 
10000011b 
10011001b 
10011001b 
10000011b 
11111111b 
11111111b 



Text Write Operations 



cape db 11111111b 

db 11000011b 

db 10011001b 

db 10011111b 

db 10011111b 

db 10011111b 

db 10011001b 

db 11000011b 

db 11111111b 

db 11111111b 

capd db 11111111b 

db 10000011b 

db 10011001b 

db 10011001b 

db 10011001b 

db 10011001b 

db 10011001b 

db 10000011b 

db 11111111b 

db 11111111b 

cape db 11111111b 

db 10000001b 

db 10011111b 

db 10011111b 

db 10000011b 

db 10011111b 

db 10011111b 

db 10000001b 

db 11111111b 

db 11111111b 

capf db 11111111b 

db 10000001b 

db 10011101b 

db 10011111b 

db 10000111b 

db 10011111b 

db 10011111b 

db 10011111b 

db 11111111b 

db 11111111b 
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Text Write Operations 



capg db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

caph db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

capi db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

capj db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
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11111111b 
1 1 0000 1 1b 
10011001b 
10011001b 
10011111b 
10010001b 
10011001b 
11000011b 
11111111b 
11111111b 

11111111b 
10011001b 
10011001b 
10011001b 
10000001b 
10011001b 
10011001b 
10011001b 
11111111b 
11111111b 

11111111b 
11000011b 
11100111b 
11100111b 
11100111b 
11100111b 
11100111b 
11000011b 
11111111b 
11111111b 

11111111b 
1 1 1 00001b 
11110011b 
11110011b 
11110011b 
11110 011b 
10010011b 
11000111b 
11111111b 
11111111b 



Text Write Operations 



capk db 11111111b 

db 10011001b 

db 10010011b 

db 10000111b 

db 10001111b 

db 10000111b 

db 10010011b 

db 10011001b 

db 11111111b 

db 11111111b 

capl db 11111111b 

db 10000111b 

db 11001111b 

db 11001111b 

db 11001111b 

db 11001111b 

db 11001101b 

db 10000001b 

db 11111111b 

db 11111111b 

capm db 11111111b 

db 00111001b 

db 00010001b 

db 00101001b 

db 00101001b 

db 00111001b 

db 00111001b 

db 00111001b 

db 11111111b 

db 11111111b 

capn db 11111111b 

db 10011001b 

db 10001001b 

db 10001001b 

db 10000001b 

db 10010001b 

db 10010001b 

db 10011001b 

db 11111111b 

db 11111111b 
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Text Write Operations 



capo db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

capp db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

capq db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

capr db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
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11111111b 
1 1 0000 1 lb 
10011001b 
10011001b 
10011001b 
10011001b 
10011001b 
1 1 00001 1b 
11111111b 
11111111b 
11111111b 
1 00000 1 lb 
1 00 1 1 00 1b 
10011001b 
1 000001 lb 
10011111b 
10011111b 
10011111b 
11111111b 
11111111b 

11111111b 
1 1 00001 lb 
1 00 1 1 00 1 b 
1 00 1 1 00 1b 
1 00 1 1 00 1b 
10010001b 
10011001b 
1 1 00000 1b 
11111 100b 
11111111b 

11111111b 
1 00000 1 lb 
1 00 1 1 00 1b 
1 00 1 1 00 1b 
10000011b 
10000111b 
10010011b 
1 00 1 1 00 1 b 
11111111b 
11111111b 



Text Write Operations 



caps db 11111111b 

db 11000011b 

db 10011001b 

db 10011111b 

db 11000111b 

db 11110001b 

db 10011001b 

db 11000011b 

db 11111111b 

db 11111111b 

capt db 11111111b 

db 10000001b 

db 11100111b 

db 11100111b 

db 11100111b 

db 11100111b 

db 11100111b 

db 11100111b 

db 11111111b 

db 11111111b 

capa db 11111111b 

db 10011001b 

db 10011001b 

db 10011001b 

db 10011001b 

db 10011001b 

db 10011001b 

db 11000011b 

db 11111111b 

db 11111111b 

capv db 11111111b 

db 10011001b 

db 10011001b 

db 10011001b 

db 10011001b 

db 10011001b 

db 11000011b 

db 11100111b 

db 11111111b 

db 11111111b 
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Text Write Operations 



capw db 11111111b 

db 00111001b 

db 00111001b 

db 00111001b 

db 00111001b 

db 00101001b 

db 00000001b 

db 00111001b 

db 11111111b 

db 11111111b 

capx db 11111111b 

db 10011001b 

db 10011001b 

db 11000011b 

db 11100111b 

db 11000011b 

db 10011001b 

db 10011001b 

db 11111111b 

db 11111111b 



capy db 11111111b 

db 10011001b 

db 10011001b 

db 11000011b 

db 11100111b 

db 11100111b 

db 11100111b 

db 11000011b 

db 11111111b 

db 11111111b 

capz db 11111111b 

db 10000001b 

db 11111001b 

db 11110011b 

db 11100111b 

db 11001111b 

db 10011101b 

db 10000001b 

db 11111111b 

db 11111111b 
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Text Write Operations 



Ibrak 



db 
db 
db 
db 
db 
db 
db 
db 
db 
db 



11111111b 
1 00000 1 lb 
10011111b 
10011111b 
10011111b 
10011111b 
10011111b 
1 00000 1 lb 
11111111b 
11111111b 



bs 1 ash 



db 
db 
db 
db 
db 
db 
db 
db 
db 
db 



11111111b 
10111111b 
10011111b 
11001111b 
11100111b 
11110011b 
11111001b 
11111101b 
11111111b 
11111111b 



rbrak 



caret 



db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 



11111111b 
1 00000 1 lb 
11110011b 
11110011b 
11110011b 
11110011b 
11110011b 
1 00000 1 lb 



1111 

1111 

1111 

1110 

11010 

1011 

1111 

1111 

1111 

1111 

1111 

1111 



111b 
1 lib 
1 lib 
111b 
111b 
011b 
1 lib 
1 lib 
111b 
111b 
111b 
1 lib 
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Text Write Operations 



under 1 



1 squo t 



lita 



litb 



db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

db 
db 
db 
db 
db 
db 
db 
db 
db 
db 



1111111b 
1111111b 
1111111b 
1111111b 
1111111b 
1111111b 
1111111b 
1111111b 
1111111b 
00000000b 

1111111b 
1100111b 
1100111b 
1110111b 
1111111b 
1111111b 
1111111b 
1111111b 
1111111b 
1111111b 

1111111b 
1111111b 
1111111b 
00000 1 lb 
1111001b 
1000001b 
0011001b 
1000001b 
1111111b 
1111111b 

1111111b 
0011111b 
0011111b 
00000 1 lb 
0011001b 
0011001b 
0011001b 
0000011b 
1111111b 
1111111b 
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Text Write Operations 



lite db 11111111b 

db 11111111b 

db 11111111b 

db 11000011b 

db 10011001b 

db 10011111b 

db 10011001b 

db 11000011b 

db 11111111b 

db 11111111b 

litd db 11111111b 

db 11111001b 

db 11111001b 

db 11000001b 

db 10010001b 

db 10011001b 

db 10010001b 

db 11000001b 

db 11111111b 

db 11111111b 

lite db 11111111b 

db 11111111b 

db 11111111b 

db 11000011b 

db 10011001b 

db 10000011b 

db 10011111b 

db 11000011b 

db 11111111b 

db 11111111b 

li tf db 11111111b 

db 11100011b 

db 11001001b 

db 11001111b 

db 10000011b 

db 11001111b 

db 11001111b 

db 11001111b 

db 11111111b 

db 11111111b 
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Text Write Operations 



litg db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

lith db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

liti db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

litj db 
db 
db 
db 
db 
db 
db 
db 
db 
db 



9-22 



11111111b 
11111111b 
11111001b 
1 1 00000 1b 
10010011b 
10010011b 
11000011b 
11110011b 
10010011b 
11000111b 

11111111b 
10011111b 
10011111b 
1 00000 1 lb 
10001001b 
10011001b 
10011001b 
10011001b 
11111111b 
11111111b 

11111111b 
11111111b 
11100111b 
11111111b 
11000111b 
11100111b 
11100111b 
10000001b 
11111111b 
11111111b 

11111111b 
11111111b 
11110011b 
11111111b 
11110011b 
11110011b 
11110011b 
11110011b 
10010011b 
1 1 000 1 lib 



Text Write Operations 



li tk db 11111111b 

db 10011111b 

db 10011111b 

db 10010011b 

db 10000111b 

db 10000111b 

db 10010011b 

db 10011001b 

db 11111111b 

db 11111111b 

li 1 1 db 11111111b 

db 11000111b 

db 11100111b 

db 11100111b 

db 11100111b 

db 11100111b 

db 11100111b 

db 11000011b 

db 11111111b 

db 11111111b 

litm db 11111111b 

db 11111111b 

db 11111111b 

db 10010011b 

db 00101001b 

db 00101001b 

db 00101001b 

db 00111001b 

db 11111111b 

db 11111111b 

li tn db 11111111b 

db 11111111b 

db 11111111b 

db 10100011b 

db 10001001b 

db 10011001b 

db 10011001b 

db 10011001b 

db 11111111b 

db 11111111b 
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Text Write Operations 



lito db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

litp db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

litq db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

litr db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
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11111111b 
11111111b 
11111111b 
11000011b 
10011001b 
10011001b 
10011001b 
11000011b 
11111111b 
11111111b 

11111111b 
11111111b 
11111111b 
10100011b 
10001001b 
10011001b 
10001001b 
1 00000 1 1b 
10011111b 
10011111b 

11111111b 
11111111b 
11111111b 
11000101b 
10010001b 
10011001b 
10010001b 
1 1 00000 1b 
11111001b 
11111001b 

11111111b 
11111111b 
11111111b 
10100011b 
10011001b 
10011111b 
10011111b 
10011111b 
11111111b 
11111111b 



Text Write Operations 



lits db 11111111b 

db 11111111b 

db 11111111b 

db 11000001b 

db 10011111b 

db 11000011b 

db 11111001b 

db 10000011b 

db 11111111b 

db 11111111b 

li tt db 11111111b 

db 11111111b 

db 11001111b 

db 10000011b 

db 11001111b 

db 11001111b 

db 11001001b 

db 11100011b 

db 11111111b 

db 11111111b 

li tu db 11111111b 

db 11111111b 

db 11111111b 

db 10011001b 

db 10011001b 

db 10011001b 

db 10011001b 

db 11000011b 

db 11111111b 

db 11111111b 

litv db 11111111b 

db 11111111b 

db 11111111b 

db 10011001b 

db 10011001b 

db 10011001b 

db 11011011b 

db 11100111b 

db 11111111b 

db 11111111b 
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Text Write Operations 



litw db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

litx db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

lity db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

litz db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
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11111111b 
11111111b 
11111111b 
00111001b 
00111001b 
00101001b 
10101011b 
10010011b 
11111111b 
11111111b 

11111111b 
11111111b 
11111111b 
10011001b 
1 1 0000 1 lb 
11100111b 
1 1 0000 1 1b 
10011001b 
11111111b 
11111111b 

11111111b 
11111111b 
11111111b 
10011001b 
10011001b 
10011001b 
1 1 1 00001b 
11111001b 
10011001b 
1 1 0000 1 1b 

11111111b 
11111111b 
11111111b 
10000001b 
11110011b 
11100111b 
11001111b 
10000001b 
11111111b 
11111111b 



Text Write Operations 



l5brak 



ver 1 1 



r sbrak 



tilde 



dseg 
cseg 

ext rn 

g t ex t 



db 
db 
db 
db 
db 
db 
db 
db 
db 
db 

db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 
db 



1111111b 
1 1 1 000 1b 
1100111b 
1001111b 
0011111b 
1001111b 
1001111b 
1100011b 
1111111b 
1111111b 

1111111b 
1100111b 
1100111b 
1100111b 
1100111b 
1100111b 
1100111b 
1100111b 
1100111b 
1111111b 
1111111b 
000 1 1 lib 
1100111b 
1110011b 
1111001b 
1110011b 
1100111b 
0001111b 
1111111b 
1111111b 



db 11111111b 
db 10011111b 
db 01100101b 
db 11110011b 
db 11111111b 
db 11111111b 
db 11111111b 
db 11111111b 
db 11111111b 
db 11111111b 
ends 

segment byte public 'codesg' 
public gtext 

mode: near, gdc_not_bu5y: near 

assume c5:c5eg,ds:dseg,e5:d5eg,ss:nothing 
proc near 
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Text Write Operations 



Ne are going to assume that the character is by t e -a 1 i gned . Anything 
else will be ignored with the char being written out to the integer 
of the byte address. 

Special conditions: if dl=Offh - don't print anything. 

1) Make sure that the Graphics Option doesn't have any pending 
operations to be completed. 

2) Turn the x,y coordinates passed in ax,bx into a cursor word 
address to be saved and then asserted to the GDC. 

3) If the current foreground/background colors are not those 
desired, assert the desired colors to the Foreground/Background 
Regi s ter . 

4) Determine in which half of the word the character is to be 
written to and then enable that portion of the write. 

5) Check to see if the character we are being requested to print is 
legal. Anything under 20h is considered to be unprintable and so we 
just exit. Ne also cons i der Of f h to be unpr intable since the Rainbow 
uses this code as a delete mar k er . 

6) Turn the character ' s code into a word offset . Use this offset to 
find an address in a table. This table is a table of near addresses 
that define the starting address of the ten bytes that is the 

part i cu lar character ' s font. Fetch the first two bytes and assert to 
the screen. We have to assert write buffer counter reset because we 
are only using two of the words in the write buffer , not all 8. 
Each byte is 1 oaded into both the left and right byte of a write 
buffer word . The GDC is programmed to perform the two- scan- line 
write and we wait for the write to finish. The next 8 scan lines 
of the character font are 1 oaded into both the left and right bytes 
of the write buffer and these eight lines are then written to the 
screen . 



push 



call 



gdc_no t_busy 



pop 



ax 



Ax = the col umn number of t he character . Bx is the row number . 



In high resolution, each bx is = 640 words 

Cursor position = (ax/2)+10*Cbx*scan line width in words) 



mov 



mov 



mov 



mov 



add 



shl 



shr 



shl 



d i , ax 
ax , 1 
cx , 6 
bx , c 1 
s i , bx 
cl ,3 
bx , c 1 
bx , s i 



; save the x so that we can check it later 

; turn col umn position into a word address 

;high resolution is 64 words per line 

; bx * s can line length 

; save a copy of scan times count 

;to get bx* 1 first mu 1 1 i p ly bx by 8 

; then 

; add in the 2*bx* scan line 1 eng t h 
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Text Write Operations 



add bx,5i ;this gives 10*bx*5can line length 

add bx,ax ;combine x and y into a word address 

mov word ptr curlO,bx ;position to write the word at 

Assert the colors attributes of the character to fgbg. Dh has the 
foreground and background attributes in it. 



cmp dh,byte ptr fg 

jz cont 

mov al,0f7h 

out 53h,al 

mov byte ptr fg,dh 

mov al , dh 

out 5 1 h , al 



;is the fgbg color the one we want? 
; j ump i f yes 



;Assert the graphics board's text mask. The GDC does 16-bit writes 
;in text mode but our characters are only 8 bits wide. Me must enable 
; hal f of the write and di sable the other half. I f the x was odd then 
; enable the r ight hal f . I f the x was even then enable the left hal f . 



cont : 



odd: 
com : 



test 

jnz 

mov 

jmp 

mov 

call 



di , 1 ; is this a first byte? 

odd ; j ump if not 

word ptr gbmsk 1 , OOf f h 
com 

word ptr gbmsk 1 , Of f OOh 

s tgbm ; asser t the graphics board mas k 



Only the charac ter s below 1 27h are defined - the others are legal 
but not in the font table . After check ing for a legal character 
fetch the address entry (character number - 20h> in the table . 
Thi s is the address of the first byte of the character ' s font . 





cmp 


dl , 1fh 


; unpr intable character? 






cont 


; j ump if not 






exit 


; don' t print i 1 legal charac ter 


cont : 


cmp 


dl ,0f fh 


; i s this a delete mar ker ? 






cont 1 


; j ump if not 




jmp 


exit 


; exi t if yes 


cont 1 : 


sub 


dl ,20h 


; table start s with a space 




xor 


dh,dh 


; at 




mov 


bx , dx 


; access table & index off bx 




shl 


bx, 1 


;byte to word address offset 




mov 


si , textabCbxl 




;Textab 


has 


the relat i ve offsets 


of each character in it. All 



to do is add the start of the font table to the relat ive offset of 
the par t icular character . 
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Text Write Operations 



add 5i, offset space ;combine table offset with 

;character offset 

;Tran5fer the font from the font table into the write buffer. 
;Nrite the first two scans, then do the last 8. 

eld ^make sure lodsb incs si. 

mov aljOfeh ;re5et the write buffer counter 

out 53h,al 

ou t 5 1 h , a 1 

lodsw ;fetch both bytes. 

out 52h,al ;put the byte into both 1 and 2 

out 52h,al ;write buffer bytes 

mov a 1 , ah 

out 52h,al ;put the byte into both 1 and 2 

out 52h,al jwrite buffer bytes 

mov aljOfeh ;reset the write buffer counter 

out 53h,al 

out 5 1 h , al 

;Check to see if already in text mode. 

test byte ptr gbmod,2 

jz textm Jj'^'Tnp if Iti text mode else 

and byte ptr gbmod,Ofdh ;assert text mode 

call mode 

textm: mov al,49h ^assert the cursor command 

out 57h , a 1 

mov ax, word ptr curlO 

out 56h , a 1 

mov a 1 , ah 

out 56h,al 

mov al,4ah ;a55ert the mask command 

out 57h,al 

mov al , Of f h 

out 56h,al 

out 56h,al 

mov al,4ch ;assert the figs command 

out 57h , a 1 

xor al,al ;assert the down direction to write 

out 56h,al 

mov al , 1 ;do it 2 write cycles 

out 56h,al 

xor a 1 , a 1 

out 56h,al 



9-30 



Text Write Operations 



mov 
out 
mov 
out 
out 



al ,22h 
57h,al 
al ,0f fh 
56h,al 
56h,al 



;a55ert the wdat command 



Nait for the first two scans to be written. 



her e 1 ; 



mov 
out 
i n 

test 
J2 



ax,422h 
57h,al 
al ,56h 
ah , a 1 
her e 1 



;make sure the GDC isn't drawing 
;write a wdat to the GDC 
;read the status register 
;did the wdat get executed? 
; j ump if not 



si is still pointing to the next scan line to be fetched. Get the 
next two scan lines and then tell the GDC to write them. No new 
cursor, GDC mask, graphics mask or mode commands need be issued. 



1 dc r : 



exit: 
5 t gbm : 



gt ex t 
cseg 



mov 


cx,8 


; e i gh t scan lines 


lodsb 




; fetch the byte 


out 


52h,al 


;put the byte into both 1 and 


out 


52h,al 


;write buffer bytes 


loop 


1 dcr 




mov 


a 1 , 4ch 


;assert the figs command 


out 


57h,al 




xor 


al , al 


;assert the down direction to 


out 


56h,al 




mov 


ax, 7 


;do 8 write cycles 


out 


56h,al 




mov 


a 1 , ah 




out 


56h,al 




mov 


al ,22h 


^assert the wdat command 


ou t 


57h,al 




mov 


al ,0f fh 




out 


56h,al 




out 


56h,al 




ret 






mov 


ax , word p t r 


gbms k 1 


out 


54h,al 




mov 


al , ah 




out 


55h,al 




ret 






endp 






ends 






end 
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Define and Position the Cursor 

There are two routines in the following example. One sets the cursor type to no cursor, block, 
underscore, or block and underscore. It then sets up the current cursor location and calls the second 
routine. The second routine accepts new coordinates for the cursor and moves the cursor to the new 
location. 



Example of Defining and Positioning the Cursor 

* * ******************************** 

* 



procedure gsettyp * 

* 



purpose : 


assert new 


cursor type * 


entry: 


dl bits det 


ermine cursor style * 




(if no bits 


set, no cursor is displayed) * 




bit = 


block * 




bit 1 = 


undef i ned * 




bit 2 = 


undefined * 




bit 3 = 


underscore * 







dseg 


segmen 


t byte pub 1 i c ' da tasg ' 


ex t r n 


cu r 1 : 


by te , cur 12 : byte , gbmod : byte 


block 


db 


0,0,0,0,0,0,0,0,0,0 


cd i s 


db 





las t c 1 


dw 







dw 





ocur s 


db 





newc 1 


dw 







dw 





ncur s 


db 





under s 


db 


0ffh,0ffh,0ffh,0ffh,0ffh,0ffh,0ffh,0ffh,0,0ffh 


user d 


db 


0,0,0,0,0,0,0,0,0,0 


dseg 




ends 



I mp 1 emen t s the new cursor type to be displayed. The current 
cursor type and location must become the old type and 1 oca t ion . 
The new type becomes whatever is in d 1 . This routine will fetch 
the previous cursor type out of NCURS and put it into OCURS and 
then put the new cursor type into NCURS . The previous cursor 
coordinates are fetched and put into ax and bx . A branch to 
GSETPOS then erases the old cursor and displays the new cursor. 
Cursor type bits are not exc 1 us i ve of each other . A cursor can 
be both an underscore and a block . 
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dl= = tarns the cursor display off 

1 = displays the insert cursor (full block) 

8 = displays the overwrite cursor (underscore) 

9 = displays a simultaneous underscore and block cursor 

cseg segment byte public 'codesg' 
extrn modernear 

assume cs:cseg,ds:d5eg,es:dseg,s5:nothing 

publ i c gset typ 



gset typ 

mov 
mov 
mov 
mov 
mov 

gsettyp endp 



proc near 
al , byte ptr ncur s 
byte ptr ocurs,al 
byte ptr ncur s , d 1 
ax, word ptr newel 
bx,word ptr newcl+2 
po s 



current cursor becomes 

old cursor type 
pick up new cursor type 
pick up current x and y 

cursor coordinates 
branch to assert new cursor 

type in old location 



procedure 



g 5 e t p o s 



purpose : 
entry: 



assert new cursor position 
ax = X 1 oca t ion 
bx = y 1 oca t i on 



gsetpos proc 



public gsetpos 
near 



Display the cursor. Cursor type was defined by GSETTYP. The 
cursor type is stored in NCURS. Fetch the type and address of the 
previous cursor and put it into OCURS and also into lastcl and 
lastcl+2. If a cursor is currently being displayed, erase it. If 
there is a new cursor to display, write it (or them) to the screen. 
A cursor may be a block or an underscore or both. 



The X and y coordinates of the cursor are converted into an address 
that the GDC can use. Either the left or the right half of the text 
mask is enabled, depending on whether the x is even or odd. The 
write operation itself takes places in complement mode so that no 
information on the screen is lost or obscured but only inverted in 
value. In order to ensure that all planes are inverted, a OfOh is 
loaded into the Foreground /Background Register and all planes are 
write enabled. The cursor is written to the screen in two separate 
writes because the write buffer is eight, not ten, words long. 
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Move current cursor type and location to previous type and location. 



mov 


cljbyte ptr ncur s 




move current cursor type 


mov 


byte ptr ocur s , c 1 




into old cursor type 


DOS : eld 








mov 


cxjword ptr newel 




move current cursor 


mov 


word ptr lastcl,cx 




location into old cursor 


mov 


ex, word ptr newcl+2 




loeat ion 


mov 


word ptr lastcl+2,cx 






mov 


word ptr newel, ax 




save new cursor coordinates 


mov 


word ptr newcl+2,bx 




in new cursor location 


;Before doing anything to the graphics 


option we need to make sure 


; that the option isn't already in use. 


Assert a harmless command 


;into the FIFO 


and wait for the GDC to 


execu t e it. 


call 


no t_busy 






;Set up the gra 


phics option. Put the Graphics Option in complement 


;and text modes 


with all planes enabled 




Assert fgbg and text mask. 


; Calculate the 


write address and store 


in cur 1 , 1 . 


mov 


ax , 1 Oef h 




address the ALU/PS 


out 


53h,al 




register 


mov 


a 1 , ah 




set complement mode with 


out 


51h,al 




all planes enabled 


; Assert text mode with read disabled. 






mov 


al,byte ptr gbmod 




get mode shadow byte 


and 


al , Of dh 




set text mode 


o r 


al , 10h 




set write enabled mode 


cmp 


al,byte ptr gbmod 




is mode already asserted 




gsposO 




this way? If yes, jump 


mov 


byte ptr gbmod, al 




update the mode register 


call 


mode 






gsposO : mov 


al,0f7h 




set Foreground/Background 


out 


53h,al 




register to invert data 


mov 


al ,0f Oh 






out 


51h,al 






;l5 a cursor currently being displayed? 




If edisoO, then yes. Any 


; current cursor 


will have to be erased 


before we display a new one. 


gipO 1 : test 


byte ptr edi s , 1 




;if no old cursor to erase. 




gspos2 




; just display old one 
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This part will erase the old cursor, 





mov 


byte ptr cdis,0 


set no cursor on screen 




mov 


dhjbyte ptr lastcl 


fetch X and y, put into dx, 




mov 


dljbyte ptr la5tcl+2 


and call dx2curl 




call 


asmas k 


assert the mask registers 




call 


dx2cur 1 


turn dx into GDC address 




test 


byte ptr ocurs ,8 


under line? 






gsposi 


• j ump if not 




mov 


s i , offset under s 


erase the underline 




cal 1 


d i s cu r s 


do the write 


gsposi : 


test 


by t e ptr ocurs, 1 


block? 






gspos2 


jump if not 




call 


not_busy ;wait till done erasing underline 




mov 


si, offset block 


erase the block 




call 


di scur s 


do the write 


; Nr i t e 


the new 


cursor out to the screen. 




gspo52: 


cmp 


byte ptr ncur s , 


write a new cursor? 






gsposB 


jump if not 




mov 


dh,byte ptr newel 


fetch coordinates of 




mov 


dl,byte ptr newcl+2 


new cursor 




call 


no t -busy 


wait for erase to finish 




call 


asmas k 


assert the mask registers 




call 


dx2curl 






test 


byte ptr ncurs ,8 


underscore cursor? 






gspos3 


jump if not 




mov 


si , offset under s 


set up for underline cursor 




call 


di scur s 


do the write 


gsposS : 


test 


byte ptr ncurs , 1 


block cursor? 






gspos4 


jump if not 




cal 1 


not-busy 


wait for any write to finish 




mov 


si, offset block 


set up for block cursor 




call 


di scur s 


do the write. 


gspo54 : 


or 


byte ptr cdis,1 


set cursor displayed flag 


g s p o 5 5 : 


call 


not-busy 






ret 






; Enab 1 e 


one byt 


e of the text mas k . 




asmas k : 


mov 


ax , OOf f h 


set up the text mask 




test 


dh, 1 


write to the right byte? 






r i t c4 


jump if yes 




mov 


ax,OffOOh 




r i t c4 : 


out 


B5h , a 1 


issue low byte of mask 




mov 


a 1 , ah 






out 


54h,al 


issue high byte of mask 




ret 







9-35 



Text Write Operations 



;Di5play the cursor. 

;A55ume that the option 15 already set up in text mode, complement 

;write and that the appropriate text mask is already set. The 

;address of the cursor pattern is loaded into the si. 

di scur 5 : 

mov a 1 , f eh 

out 53h , a 1 

out 5 1 h , a 1 
lodsb 

out 52h , a 1 

out B2h , a 1 
lodsb 

out 52h , a 1 

out B2h , a 1 

mov a 1 , f eh 

out 53h , a 1 

out 5 1 h , a 1 

mov a 1 , 49h 

out 57h , a 1 



mov 


ax , word p t r 


curio 


out 


56h,al 




mov 


a 1 , ah 




out 


56h,al 




mov 


al , 4ah 


; issue the GDC mask command to 


out 


57h,al 


; set all GDC mask bits 


mov 


al , Of f h 




out 


56h,al 




out 


56h,al 




mov 


a 1 , 4ch 


jprogram a write of ten scans 


out 


57h,al 


; first do two scans, then eight 


xor 


al ,al 




out 


56h,al 




mov 


al , 1 




out 


B6h,al 




xor 


a 1 , a 1 




out 


56h,al 




mov 


al ,22h 


;start the write 


out 


57h,al 




mov 


al ,0f fh 





out 56h,al 

out 56h,al 

call not-busy ;wait for first 

mov cx,8 ;then write the 



jselect the write buffer and clear 
; the write buffer counter 



;feed the same byte to both halves 
; of the word to be written 

feed the same byte to both halves 
of the word to be written 

select the write buffer and clear 
the write buffer counter 

;assert the position to write 



two lines to finish 
next 8 scans 
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lod5b 




;fetch the cursor shape 


out 


52h,al 


; f eed the same byte to both halves 


out 


52h,al 


; of the word 


loop 


r i t c6 




mov 


a 1 , 4ch 


;program a write of eight scans 


out 


57h,al 




xor 


a 1 , a 1 




out 


56h,al 




mov 


al ,7 




out 


56h,al 




xor 


a 1 } a 1 




out 


56h,al 




mov 


al ,22h 


; 5 tar t the write 


out 


57h,al 




mov 


al , Of fh 




out 


56h,al 




out 


56h,al 




ret 







Turn dh and dl into a word address (dl is the line and dh 

is the column). Store the result in word ptr curlO. Start with 

turning dl (line) into a word address. 

Nord address = dl * number of words/line * 10 



Turn dh (column) into a word address. 



; Word address = dh/2 

^Combine the two. This gives the curlO address to be asserted to 
;the GDC. 

dx2cur 1 : 



mov 


al, 


dh 


jstore the column count 


mov 


cl, 


5 


;medium resolution = 32 words/line 


test 


byt 


e ptr 


gbmod,1 ;is it high resolution? 


j2 


ri t 


c5 


; j ump if not 


i nc 


cl 




•,high resolution = 64 words/line 


xor 


dh, 


dh 




shl 


dx, 


cl 




mov 


bx. 


dx 


;multiply dx by ten 


mov 


cl , 


3 




shl 


bx. 


1 




shl 


dx. 


cl 




add 


dx, 


bx 


;this is the row address 


shr 


al, 


1 


;this is the column number 
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xor 
add 
mov 
ret 



ah , ah 
dx , ax 

word ptr curlO,dx 



;thi5 i5 the combined row and 
;column address 



This is a quicker version of GDC_NOT_BUSY . We don't waste time on 
some of the normal checks and things that GDC_NOT_BUSY does due to 
the need to move as quickly as possible on the cursor erase/write 
routines. This routine does the same sort of things. A harmless 
command is issued to the GDC. If the GDC is in the process of 
performing some other command, the WDAT we just issued 
will stay in the GDC's command FIFO until such time as the GDC can 
get to it. If the FIFO empty bit is set, the GDC executed the 
WDAT command and must be finished with any previous operations 
programmed into it. 



no t -busy : 



busy: 



cseg 



mov 


ax,422h 


out 


57h,al 


i n 


al ,56h 


test 


ah , al 




busy 


ret 




endp 




ends 




end 





;assert a WDAT 

;wait for FIFO empty bit 



Write a Text String 

The example in this section writes a string of ASCII text starting at a specified location and using a 
specified scale factor. It uses the vector write routine from Chapter 8 to form each character. 

Example of Writing a Text String 

# 

; procedure vector_text * 

* 

; entry: cx = string length * 

; text = pointer to externally defined array of * 

; ASCII characters * 

; scale = character scale * 

; xinit^startingxlocation * 

; yinit = starting y location * 
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C5eg segment byte public 'codesg' 

extrn imodeinear, pattern _mult:Tiear,pattern_regi5ter:near 

extrn vectorinear 

public vector_text 

assume cs:c5eg,ds:dseg,es:dseg,ss:nothing 

vector_text proc near 

or byte ptr gbmod,082h 

call imode ;ensure we're in graphics mode 

mov a 1 , 4ah 

out 57h , a 1 

mov a 1 , f f h 

out 56h , a 1 

out 56h,al ;enable GDC mask data write 

xor al,al ;enable all option mask writes 

out 55h , a 1 

out 54h , al 

mov b 1 , 1 

call pattern_mult ;5et pattern multiplier 

mov bl,Offh 

call pattern-register ;set pattern register 

mov ax, word ptr xinit jget initial x 

mov word ptr xad,ax ;save it 

mov ax, word ptr yinit Jget initial y 

mov word ptr yad,ax ; save it 

mov si, offset text 
do_5 t r i ng : 

lodsb ;get character 

push si 

push cx 

call display-character ^display it 

mov ax, 8 

mov cl,byte ptr scale ;move over by cell value 

mul cx 

add word ptr xad,ax 

pop cx 

pop s i 

loop do_string ;loop until done 

ret 

display-character : 

cmp al,07fh ;make sure we're in font table 

jbe char-cont_1 ;continue if we are 

ret 

char-con t- 1 : 

cmp al,20h ;check if we can print character 

ja char_cont ;continue if we can 

ret 
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char_cont: 

xor ah, ah ;clear high byte 

shl ax,1 ;mal(e it a word pointer 

mov 5 i , ax 

mov 5 i , f on t-.table C 5 i ] ;point si to font info 

get_next_5 troke : 

mov ax, word ptr xad 

mov word ptr xinit,ax 

mov ax, word ptr yad 

mov word ptr yinit,ax 

lodsb ;get stroke info 

cmp al,endc ;end of character ? 

jnz cont-.1 ;continue if not 

ret 

cont_ 1 : mov bx , ax 

and ax,Ofh jmask to y value 

test al,08h ;negative ? 

jz ct 

or ax,OfffOh ;5ign extend 

ct: mov cl,byte ptr scale 

xor ch,ch 

push cx 

imul cx ;multiply by scale value 

sub word ptr yinit,ax ;subtract to y offset 

and bx,OfOh jmask to x value 

shr bx,1 ;shift to four least 

shr bx,1 ; significant bits 

shr bx , 1 

shr bx , 1 

test bl,08h ;negative ? 

jz ct1 

or bx,OfffOh ;sign extend 

c t 1 : mov ax , bx 

pop cx ^recover scale 

imul cx ;multiply by scale value 

add word ptr xinit,ax ;add to x offset 



9-40 



Text Write Operations 



nex t _5 t ro k e : 



ct2: 



ct3: 



mov 


ax, word ptr xad 


;set up xy offsets 


mov 


word ptr xfinal,ax 




mov 


ax, word ptr yad 




mov 


word ptr yfinal,ax 




lodsb 




; get stroke byte 


cmp 


al , endc 


;end of character ? 


jz 


display-char.exit 


;ye5 then leave 


cmp 


a 1 , endv 


;dark vector ? 


jz 


g e t _ n e X t _ s t r o k e 


; yes , beg i n aga i n 


mov 


bx , ax 




and 


ax , Of h 


; mask to y value 


test 


al ,08h 


; nega t i ve 


j z 


ct2 




or 


ax,Of f f Oh 


;5ign extend 


mov 


c 1 , byte ptr scale 


;get scale information 


xor 


ch , ch 




push 


cx 




imu 1 


cx 


■,multiply by scale 


sub 


word ptr yfinal,ax 


;subtract to y offset 


and 


bx,Of Oh 


;mask to x value 


shr 


bx, 1 


;shift to four least 


shr 


bx, 1 


; s i gn i f leant bits 


shr 


bx, 1 




shr 


bx, 1 




test 


bl ,08h 


;negative ? 


jz 


ct3 




or 


bx, Of f f Oh 


; s i gn extend 


mov 


ax , bx 




pop 


cx 


; recover scale 


imu 1 


cx 


;multiply by scale 


add 


word ptr xfinal,ax 


;add to x offset 


push 


5 1 


;save index to font info 


call 


vec t o r 


;draw stroke 


pop 


s i 


;recover font index 


mov 


ax, word ptr xfinal 


end of stroke becomes 


mov 


wordptr xinit,ax 


; beginning of next stroke 


mov 


ax, word ptr yfinal 




mov 


word ptr y i ni t , ax 




jf"P 


nex t _s t r o k e 




.char _ 


exit : 





ret 

vec tor_t ex t 



endp 



cseg ends 

dseg segment byte public 'datasg' 

extrn gbmod:byte,xinit:word,yinit:word,xfinal:word,yfinal:word 

extrn xad:word, yad :word,text:byte 

publ ic scale 
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* stroke font character set * 

* # 
*♦♦«*»«♦*♦****#«»*»«##«#««♦#♦*#**#*#««»»#»####♦»«««♦»#»»##«*♦»»«## 

The following tables contain vertex data for a stroked character 

set. The x and y coordinate information is represented by 4-bit, 

2s-complement numbers in the range of + or - 7. The x and y bit 
positions are as follows: 

bit 7 6 5 4 3 2 10 

I II I 

I II I 

\ / \ / 

^ y 

End of character is represented by the value x = -8, y = -8. 
The dark vector is represented by x = -8, y = 0. 



;ASCII characters are mapped into the positive quadrant, with the 
;origin at the lower left corner of an upper case character. 

endc equ 10001000b ;end of character 

endv equ 10000000b ;last vector of polyline 
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dw 


offset 


font 


_7c 


dw 


offset 


font 


_7d 


dw 


offset 


font 


_7e 


dw 


offset 


font 


_7f 



f ont_00 


db 


endc 


font_01 


db 


endc 


f ont_02 


db 


endc 


f ont_03 


db 


endc 


f ont_04 


db 


endc 


f ont_05 


db 


endc 


f ont_06 


db 


endc 


f ont_07 


db 


endc 


f ont_08 


db 


endc 


f ont_09 


db 


endc 


f o n t _ a 


db 


endc 


f ont_Ob 


db 


endc 


f o n t _ c 


db 


endc 


f ont_Od 


db 


endc 


f ont_Oe 


db 


endc 


f ont_Of 


db 


endc 


f ont_10 


db 


endc 


f ont_1 1 


db 


endc 


f ont_12 


db 


endc 


f ont_13 


db 


endc 


f ont_14 


db 


endc 


f ont_15 


db 


endc 


f ont_16 


db 


endc 


f ont_17 


db 


endc 


f ont_18 


db 


endc 


f ont_19 


db 


endc 


f on t _ 1 a 


db 


endc 


f ont_1b 


db 


endc 


f on t _ 1 c 


db 


endc 


f ont_1d 


db 


endc 


font- 1 e 


db 


endc 


f ont_1f 


db 


endc 


f ont_20 


db 


endc 
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f ont_21 
f ont_22 
f ont_23 

f ont_24 

foTit_25 

f oTit_26 
f ont_27 
f ont_28 
font_29 
f ont_2a 

f ont_2b 
f ont_2c 
font_2d 
f ont_2e 
font_2f 
f ont_30 
f ont_31 
f ont_32 
f on t _33 

font_34 
f on t_35 
f on t _36 

f ont_37 
f ont_38 

f ont_39 

f on t_3a 

f on t_3b 

f on t_3c 
f on t _3d 
f on t _3e 
f ont_3f 

f ont_40 

f ont_41 
font_42 



db 20h,21h 
db 24h,26h 
db 20h,26h 
db endc 
db 2fh,27h 
db 16h,36h 
db 11h,55h 
db 42h,41h 
db 50h, 14h 
db 34h,36h 
db 4eh, 1 1h 
db Oeh,31h 
db 30h,36h 
db endc 
db 30h,36h 
db 11h,20h 
db 03h,63h 
db 00h,01h 
db 00h,01h 
db 01h,05h 
db 04h,26h 
db 05h,16h 
db 05h,16h 



db 13h , 033h , endc 



db 06h,03h 
db 01h, 10h 
db 02h, 13h 
db endc 
db 06h,46h 
db 01h,02h 
db 30h, 10h 
db 01h, 10h 
db endc 
db 15h,25h 
db endc 
db 15h,25h 
db endc 
db 30h,03h 



db 10h,43h 
db 06h, 17h 
db endc 
db 50h, 10h 
db 35h,55h 
db 00h,04h 
db 00h,06h 



endv , 23h , 26h , endc 
endv,54h,56h,endc 

endv, 40h , 46h , endv, 04h ,64h , endv, 02h ,62h 

endv,01h, 1 Oh , 30h , 4 1 h , 42h , 33h , 13h,04h,0 5h 
045h , endc 

endv, 14h, 15h,25h,24h, 1 4h , endv , 4 1 h , 5 1 h , 52h 
endc 

15h,26h,36h,45h,44h, 1 1h, 1 Oh , 30h , 52h , endc 
endc 

1 4h , 47h , endc 
34h , 07h , endc 

endv, 1 1h,55h,endv, 15h,51h,endv,03h,63h 

endv, 03h, 63 h, endc 
2f h , Odh , endc 
endc 

1 1h, 10h,00h,endc 
45h , 46h , endc 

16h,36h,45h,41h,30h, 10h,0 1h,endc 
20h , endv, 00h,040h,endc 
36h,45h,44h, 0h,4 0h, 041h,endc 
36h,45h,44h,33h,42h,41h,30h, 10h,01h,endv 



43h , endv, 20 h , 026h , endc 
30h,41h,42h,33h, 03h, 06h, 46h ,endc 
33h,42h,41h,30h, 10h,01h,05h, 16h,36h,045h 

44h,00h,endc 

13h, 04h, 05h, 1 6h , 36h , 45h , 44h , 33h , 42h , 4 1 h 
01h,endv, 1 3h , 023h , endc 

30h,41h,45h,36h, 16h,05h,0 4h, 13h,33h,0 44h 
24h, 14h, 15h,endv, 12h,22h,21h, 1 1h, 12h 
24h, 14h, 15h,endv,21h, 1 1h, 12h,22h,20h, 1fh 
036h,endc 



db 02h,042h, endv, 04h,044h, endc 



1 6h , endc 

37h,46h,45h,34h,24h,022h,endv,21h,020h 

01h,06h, 17h,B7h,66h,63h,52h,32h,23h,24h 
064h , endc 

26h,44h, 040h,endv, 03h, 043h,endc 
36h,45h,44h,33h,42h,41h,30h, 0h,endv 



db 03h,033h,endc 
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font 


_43 


db 


45h 


36h, 16h,05h,01h,10h,30h,041h,endc 


font 


_44 


db 


OOh 


06h,36h,45h,41h,30h,0 0h,endc 


font 


_45 


db 


40h 


00h,06h,046h,endv,03h,023h,endc 


font 


_46 


db 


OOh 


06h , 046h ,endv,03h,023h,endc 


font 


_47 


db 


45h 


36h ,16h,05h,01h,10h,30h,41h,43h,023h,endc 


font 


_48 


db 


OOh 


06h,endv,03h,043h,endv,40h, 46h , endc 


font 


_49 


db 


10h 


030h,endv,20h, 026h , endv , 16h , 036h , endc 


font 


_4a 


db 


01h 


10h,30h,41h,046h,endc 


font 


_4b 


db 


OOh 


06h,endv, 02h, 46h,endv, 13h,040h,endc 


font 


_4c 


db 


40h 


OOh, 06h,endc 


font 


_4d 


db 


OOh 


06h,24h,46h, 040h,endc 


font 


-4e 


db 


OOh 


06h , endv, 05h , 04 1h , endv, 4 Oh , 046h , endc 


font 


_4f 


db 


01h 


05h, 16h,36h,45h,41h,30h, 10h,01h,endc 


font 


-50 


db 


OOh 


06h,36h,45h, 44h,33h, 03h,endc 


font 


_51 


db 


12h, 


30h,10h,01h,0 5h, 1 6h , 36h , 45h , 4 1 h , 30 h , endc 


font 


_52 


db 


OOh 


06h,36h,45h,44h,33h, 03h,endv, 13h, 04 0h,end 


font 


_53 


db 


01h 


10h,30h,41h,42h,33h, 13h,04h,05h, 16h,36h 






db 


045h , endc 


font 


_54 


db 


06h 


46h , endv, 20h , 026h , endc 


font 


-55 


db 


06h 


01h, 10h,30h,41h,046h,endc 


font 


_56 


db 


06h 


02h,20h,42h,046h,endc 


font 


_57 


db 


06h 


OOh, 22h,40h,046h, endc 


font 


_58 


db 


OOh 


1h,45h, 046h,endv,4 0h,41h, 05h, 06h,endc 


font 


_59 


db 


06h 


24h ,020h,endv,24h,46h,endc 


font 


_5a 


db 


06h 


46h,45h, 01h, 0h,4 0h,endc 


font 


_5b 


db 


37h 


17h, 1fh,3fh,endc 


font 


-5c 


db 


06h 


05h,41h,40h,endc 


font 


_5d 


db 


17h 


37h,3fh,2fh,endc 


font 


_5e 


db 


04h 


26h , 044h ,endc 


font 


_5f 


db 


Ofh 


07f h,endc 


font 


_60 


db 


54h 


36h , endc 


font 


-61 


db 


40h, 


43h,34h, 14h,03h,01h, 1 Oh , 30h , 04 1 h , endc 


font 


_62 


db 


06h 


01h, 10h,30h,41h,43h,34h, 14h,03h,endc 


font 


_63 


db 


41h, 


30h, 10h,0 1h,03h, 1 4h , 34h , 043h , endc 


font 


_64 


db 


46h 


41h,30h, 10h,01h,03h, 1 4h , 34h , 43h , endc 


font 


_65 


db 


41h 


30h, 10h,01h,03h, 1 4h , 34h , 43h , 42h , 2h , endc 


font 


-66 


db 


20h, 


25h, 36h,46h,55h, end V, 03h,43h, endc 


font 


_67 


db 


41h, 


30h, 10h,01h,03h, 1 4h , 34h , 43h , 4f h , 3eh , 1eh 






db 


Ofh, 


endc 
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font 


_68 


db 


00h,06h,endv,03h,14h,34h,43h,40h,endc 


font 


_69 


db 


20h,23h,endv,25h, 26h , endc 


font 


_6a 


db 


46h,4Bh,endv,43h,4fh,3eh, 1eh, Ofh,endc 


font 


_6b 


db 


OOh, 06h,endv, 01h,34h,endv, 12h,30h, endc 


font 


_6c 


db 


20h , 26h , endc 


font 


_6d 


db 


OOh, 04h,endv,03h,14h,23h,34h,43h,40h, endc 


font 


_6e 


db 


OOh, 04h,endv,03h,14h,34h,43h,40h, endc 


font 


_6f 


db 


01h,03h,14h,34h,43h,41h,30h,10h,01h,endc 


font 


_70 


db 


04h,0eh,endv,01h,10h,30h,41h,43h,34h,14h 






db 


03h , endc 


font 


_71 


db 


41h,30h,10h,01h,03h,14h,34h,43h,endv,44h 






db 


4 eh , endc 


font 


_72 


db 


00h,04h,endv,03h, 14h,34h,endc 


font 


_73 


db 


01h,10h,30h,41h,32h,12h,03h,14h,34h 






db 


43h , endc 


font 


_74 


db 


04h,44h,endv,26h,21h,30h,40h,51h,endc 


font 


_75 


db 


04h,01h,10h,30h,41h,endv,44h,40h,endc 


font 


_76 


db 


04h,02h,20h,42h,44h,endc 


font 


_77 


db 


4h , OOh , 22h , 4 0h , 44h , endc 


font 


_78 


db 


OOh, 44h,endv,04h,40h, endc 


font 


_79 


db 


4h,01h, 10h,30h,41h,endv,44h,4fh,3eh, 1eh 






db 


f h , endc 


font 


_7a 


db 


04h,44h, OOh, 40h, endc 


font 


_7b 


db 


40h, 11h,32h,03h,34h, 15h,46h,endc 


font 


_7c 


db 


20h , 23h , endv , 25h , 27h , endc 


font 


_7d 


db 


0h,31h, 12h,43h, 1 4h , 35h , 06h , endc 


font 


_7e 


db 


06h,27h,46h,67h,endc 


font 


_7f 


db 


07, 77, endc 



scale db 
dseg ends 
end 
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The Read Process 

Programming a read operation is simpler than programming a write operation. From the Graphics 
Option's point of view, only the Mode and ALU/PS registers need to be programmed. There is no 
need to involve the Foreground/Background Register, Text Mask, Write Buffer, or the Pattern 
Generator. GDC reads are programmed much like text writes except for the action command which 
in this case is RDAT. When reading data from the bitmap, only one plane can be active at any one 
time. Therefore, it can take four times as long to read back data as it did to write it in the first 
place. 

Read the Entire Bitmap 

In the following example, the entire bitmap, one plane at a time, is read and written into a 64K byte 
buffer in memory. This example compliments the example of displaying data from memory found in 
Chapter 7. 
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Example of Reading the Entire Bitmap 

procedure redvid * 

* 

purpose: this routine will read out all of display * 

memory, one plane at a time, then store * 

that data in a 64k buffer in motherboard * 

memory. * 

entry: * 

exit: * 

registeru5age:ax,cx,di * 
#♦*♦*#*#*####«#*#####*###*##*#*#*»##♦#*####**♦«#####****#♦***#*#*#*# 

dseg segment byte public 'datasg' 

extrn num_planes:byte,gbmod:byte,nmredl:word,gt em p: word, curlO: word 
dseg ends 

vidseg segment byte public 'vseg' 

pub 1 i c vi dda ta 
viddata db Offffh dup (?) 

vidseg ends 

cseg segment byte public 'codesg' 

extrn gdc_not_busy:near, alups: near, fgbg: near, init_option:near 
extrn mode:near 

assume cs:cseg,ds:dseg,es:d5eg,ss: nothing 

public redvid 

redvid proc near 

Set up to enable reads. The Graphics Option has to disable writes 
in the ALU/PS, enable a plane to be read in the Mode Register, and 
program the GDC to perform one plane's worth of reads. 
GDC programming consists of issuing a CURSOR command of 0, a mask 
of FFFFh, a FIGS command with a direction to the right and a read 
of an entire plane, and finally the RDAT command to start the read 
in motion. Note that the GDC can't read in all 8000h words of a 
high resolution plane but it doesn't matter because not all 8000h 
words of a high resolution plane have useful information in them. 
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cld 




1 


clear the direction flag 


call 


gdc_no t_ 


Dusy ; 


make sure the GDC is not busy 


mov 


al , Oefh 






out 


53h,al 






mov 


al , Of h 




disable all writes 


out 


51h,al 






mov 


ax,3f f f h 


7 


assume high resolution read 


test 


byte ptr 


gbmod , 1 


;actually high resolution? 




rd1 


7 


jump if yes 


mov 


ax,2000h 


7 


medium resolution no. of reads 


mov 


wo r d ptr 


nmr ed 1 , ax 



Blank the screen. This will let the GDC have 100% use of the time 
to read the screen in. 

mov aljOch ;blank command 

out 57h , a 1 

Set up to transfer data as it is being read from the screen into 
the VIDSEG data segment. 



mov 


ax , vi dse 


9 


; set 


up the es register to point 


mov 


es , ax 




; to the video buffer 


mov 


di ,0 




; start at beginning of the buffer 


mov 


c 1 , by t e 


ptr 


num_planes ;init routine sets this byte 


xor 


ch , ch 




; num. 


-planes = 2 or 4 


mov 


word ptr 


gt emp , cx 


; save plane count 


mov 


al ,Obfh 






;address the mode register 


out 


53h,al 








mov 


a 1 , by t e 


ptr 


num_planes jfigure which plane to enable 


sub 


a 1 , c 1 








shl 


al , 1 






jshift to enable bits over 2 


shl 


al , 1 








mov 


ah , by t e 


ptr 


gbmod 


mode byte = no graphics. 


and 


ah, Oe1h 






plane to read, write enable 


or 


al , ah 






combine with plane to read 


out 


51h,al 






assert new mode 


mov 


al ,49h 






position the GDC cursor to 


out 


57h,al 






top left 


xor 


al , al 








out 


56h,al 








out 


56h,al 








mov 


a 1 , 4ah 






set all bits in GDC mask 


out 


57h,al 








mov 


al , Of fh 








out 


56h,al 








ou t 


56h,al 
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mov 


a 1 , 4ch 






;a55ert the FIGS command 


out 


B7h,al 








mov 


al ,2 






;directionis to the right 


out 


56h,al 








mov 


ax , word 


p t r 


nmr ed 1 


; number of word reads to do 


out 


56h,al 








mov 


a 1 , ah 








out 


56h,al 








mov 


al , OaOh 






jstart the read operation now 


out 


b /h , a 1 








mov 


cx , word 


p t r 


nmr ed 1 


;read in as they are ready. 


5hl 


cx , 1 






;bytes = 2 * words read 


i n 


al ,56h 






;byte ready to be read? 


test 


al , 1 










rd4 






; j ump if not 


i n 


al ,57h 






; read the byte 


5 t osb 








; store in vidseg 


loop 


rd4 








i n i shed 


r eadi ng 


all 


of the 


information out of that plane. 



If high resolution, increment di by a word because we were one 



;word short of 


the entire 32k high 


resolution plane. Recover the 


; p lane 


to read 


count and loop if not done. 




test 


byte p t r gbmod , 1 


;high resolution? 






rd5 


; j ump if not 




s t osw 


;dummy stos 


to keep no. reads=words/plane 


rd5: 


mov 


cxjword ptr gtemp 






loop 


rd2 


;loop if more planes to be read 


; Ne ' r e 


done with the read. 




; Restore video 


refresh and set the 


high/medium resolution flag byte 


; a t the 


end of 


vidseg so that when 


it is written back into the video 


; we do 


it in the proper resolution. 






mov 


al,Odh 


;unblank the screen 




out 


57h,al 






test 


byte ptr gbmod , 1 


; high res? 






rd6 


; j ump if yes 




xor 


al,al ;la5t byte = for medium resolution 






rd7 




rd6: 


mov 


al,Offh jlast byte = ff for high resolution 


rd7: 


mov 


di ,0f f ffh 


;set the resolution flag 




mov 


byte ptr es : [ di ] , al 






mov 


ax , dseg 






mov 


es , ax 


jrestore es 




ret 






redvi d 


endp 






cseg 


ends 








end 
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Pixel Write After a Read Operation 

After a read operation has completed, the graphics option is temporarily unable to do a pixel write. 
(Word writes are not affected by preceding read operations.) However, the execution of a word write 
operation restores the option's ability to do pixel writes. Therefore, whenever you intend to do a 
pixel write after a read operation, you must first execute a word write. This will ensure that 
subsequent vectors, arcs, and pixels will be enabled. 

The following code sequence will execute a word write operation that will not write anything into the 
bitmap. The code assumes that the GDC is not busy since it has just completed a read operation. It 
also assumes that this code is entered after all the required bytes have been read out of the FIFO 
buffer. 

procedure writ e__a f t e r__r e a d * 

purpose: Execute a no-op word write after read operation is * 

compl et ed . * 

cseg segment byte public 'codesg' 

extrn imode : near , al ups : near 

public wr i t e_af t er_r ead 

assume cs:cseg,ds:dseg,e5: nothing, ss: nothing 



write_after_read 

mov a 1 , Odh 

out 57h , al 



proc near 
sometimes the GDC will not accept the 

first command after a read - this command 
can safely be missed and serves to ensure 
that the FIFO buffer is cleared and 
pointing in the right direction 



xor 


bl ,bl 


restore write enable replace mode to a 


11 


call 


a 1 ups 


planes in the ALU/PS Register 




mov 


al , Of f h 


disable writes to all bits at the 




out 


55h,al 


option's Mask Registers 




out 


54h,al 






or 


byte pt r 


gbmod,10h ;enable writes to Mode Regis 


t er 


call 


imode 


;it is already in word mode 




mov 


al , 4ch 


unnecessary to assert cursor or mask s 


i nee 


out 


57h,al 


it doesn't matter where you write - 


the 


xor 


a 1 , a 1 


; write is completely disabled anyway 




out 


56h,al 


, just going through the word write 




out 


56h,al 


operation will enable subsequent pixel 


out 


56h,al 


wr i t e s 
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mov al,22h 

out 57h,al ^execute the write operation 

ret 

wr i t e_af t er _r ead endp 
cseg ends 

dseg segment byte public 'datasg' 
extrn gbmodibyte 
dseg ends 
end 
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Vertical Scrolling 

The Scroll map controls the location of 64-word blocks of display memory on the video monitor. In 
medium resolution mode, this is two scan lines. In high resolution mode, this is one scan line. By 
redefining scan line locations in the Scroll Map, you effectively move 64 words of data into new 
screen locations. 

All Scroll Map operations by the CPU start at location zero and increment by one with each suc- 
ceeding CPU access. The CPU has no direct control over which Scroll Map location it is reading or 
writing. All input addresses are generated by an eight-bit index counter which is cleared to zero 
when the CPU first accesses the Scroll Map through the Indirect Register. There is no random 
access of a Scroll Map address. 

Programming the Scroll Map involves a number of steps. First ensure that the GDC is not currently 
accessing the Scroll Map and that it won't be for some time (the beginning of a vertical retrace for 
example). Clearing bit 5 of the Mode Register to zero enables the Scroll Map for writing. Clearing 
bit 7 of the Indirect Register to zero selects the Scroll Map and clears the Scroll Map Counter to 
zero. Data can then be entered into the Scroll Map by writing to port 51h. When the programming 
operation is complete or just before the end of the vertical retrace period (whichever comes first) 
control of the Scroll Map addressing is returned to the GDC by setting bit 5 of the Mode Register to 
one. 
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If, for some reason, programming the Scroll Map requires more than one vertical retrace period, 
there is a way to break the operation up into two segments. A read of the Scroll Map increments the 
Scroll Map Index Counter just as though it were a write. You can therefore program the first half, 
wait for the next vertical retrace, read the first half and then finish the write of the last half. 



Example of Vertical Scrolling One Scan Line 



* 

procedurevscroll * 

purpose: move the current entire screen up one scan line * 

entry: * 
exit: * 
register usage: ax,cx,di,si * 

dseg segment byte public 'datasg' 

extrn scr 1 tb : by t e , g temp 1 : by t e , s tar 1 1 : by t e , gbmod : by t e ;see Example 3 
dseg ends 

cseg segment byte public 'codesg' 
extrn a5crol:near ;defined in Example 3. 

assume c5:c5eg,d5:dseg,es:dseg,ss:nothing 
pub 1 ic vscroll 

■) 

vscroll proc near 
The scrollmap controls which 64 word display memory segment will be 
displayed on a particular screen line. The scroll map will display 
on the top high resolution scan line the 64-word segment denoted by 
the data loaded into location 0. If the data is a 0, the first 
64-word segment is accessed. If the data is a 10, the 11th 64-word 
segment is displayed. By simply rewriting the order of 64-word 
segments in the scroll map, the order in which they are displayed is 
correspondingly altered. If the entire screen is to be scrolled up 
one line, the entire scroll map's contents are moved up one location. 
Data at address 1 is moved into address 0, data at address 2 is moved 
into address 1 and so on. A split screen scroll can be accomplished 
by keeping the stationary part of the screen unchanged in the scroll 
map while loading the appropriate information into the moving window. 
If more than one scroll map location is loaded with the same data, 
the corresponding scan will be displayed multiple times on the screen. 
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Note that the information in the bitmap hasn't been changed, only the 
location where the information is displayed on the video monitor has 
been changed. When the lines that used to be off the bottom of the 
screen scroll up and become visible, they will have in them whatever 
had been written there before. If a guaranteed clear scan line is 
desirable, the off-screen lines should be cleared with a write before 
the scroll takes place. 



In medium resolution, only the first 128 scroll map entries have 
meaning because while each medium resolution scan is 32 words long, 
each scroll map entry controls the location of 64 words of data. In 
medium resolution, this is the same as two entire scans. The scroll 
map acts as if the most significant bit of the scroll map entries was 
always 0. Loading an 80h into a location is the same as loading a 0. 
Loading an 81h is the equivalent to writing a 1. The example shown 
below assumes a high resolution, 256 location, scrollmap. Had it 
been medium resolution, only the first 128 scans would have been 
moved. The other 128 scroll map locations still exist but are of no 
practical use to the programmer. Nhat this means to the applications 
programmer is that in medium resolution, after the scroll map has 
been initialized, the first 128 entries are treated as if they were 
the only scroll map locations in the table. 



Save the contents of the first section of the scroll table to be 
overwritten, fetch the data from however many scans away we want to 
scroll by, then move the contents of the table in a circular fashion. 
The last entry to be written is the scan we first saved. After the 
shadow scroll table has been updated, it can then be asserted by a 
call to the "ascrol" routine in the " i n i t _op t i on" procedure. 



mov 

mov 

lodsb 

mov 

mov 

rep 

mov 

5 t osb 

call 

ret 

vscroll endp 
cseg ends 
end 



si, off set scrltb 
d i , s i 

byte ptr gtemp1,al 

cx,255 

movs w 

al,byte ptr gtempi 
ascrol 



set the source of the data 

set the destination of the data 

fetch the first scan 

and save it 
move the other 255 scroll 

table bytes 
recover the first scan and put 

it into scan 256 location 
assert updated scroll table 

to scroll map 
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Horizontal Scrolling 

Not only can the video display be scrolled up and down but it can also be scrolled from side to side 
as well. The GDC can be programmed to start video action at an address other than location 0000. 
Using the PRAM command to specify the starting address of the display partition as 0002 will 
effectively shift the screen two words to the left. Since the screen display width is not the same as 
the number of words displayed on the line there is a section of memory that is unrefreshed. The 
data that scrolls off the screen leaves the refresh area and it will also be unrefreshed. To have the 
data rotate or wrap around the screen and be saved requires that data be read from the side about 
to go off the screen and be written to the side coming on to the screen. If the application is not 
rotating but simply moving old data out to make room for new information, the old image can be 
allowed to disappear into the unrefreshed area. 

Although the specifications for the dynamic RAMs only guarantee a data persistence of two milUsec- 
onds, most of the chips will hold data much longer. Therefore, it is possible to completely rotate 
video memory off one side and back onto the other. However, applications considering using this 
characteristic should be aware of the time dependency and plan accordingly. 

Example of Horizontal Scrolling One Word 



* 



procedure 



h 5 c r o 1 1 



« 



purpose : 



move the current entire screen to right 
or left a word address. 



* 



entry: 



if al = 0< move screen to the left, 
if al <> 0, move screen to the right. 



* 



exit: 



* 



register usage: ax 



The GDC is programmable (on a word boundary) as to where it starts 
displaying the screen. By incrementing or decrementing that starting 
address word we can redefine the starting address of each scan line 
and thereby give the appearance of horizontal scrolling. Assume that 
this start window display address is stored in the variables: startl 
and starth. Let's further assume that we want to limit scrolling to 
one scan line's worth. Therefore, in high resolution we can never 
issue a starting address higher than 63; in medium resolution, none 
higher than 3 1 . 
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segmen t 


byte public 'datasg' 






ex t r n 


scr 1 t b : 


by te , g t em 


p1 :byte,startl :byte,gbmod:byte 


dseg 


ends 










cseg 


segmen t 


byte public 'codesg' 






ex t r n 


gdc_no t 


-busy : near 






as same 


c s : c 5 eg 


, ds : dseg , 


es :dseg, ss: nothing 






public 


hscrol 1 








7 

hscrol 1 


pr oc 


near 










or 


a 1 , a 1 




move 


screen to left? 




i z 
J 


hs1 




jump 


if not 




dec 


byte ptr 


s t ar 1 1 


move 


screen to right 






hs2 








hs1 : 


i nc 


byte ptr 


s t ar 1 1 


move 


screen to left 


h52: 


test 


byte ptr 


gbmod , 1 


high 


res? 






hs3 




jump 


if yes 




and 


byte ptr 


startl ,31 


limit 


to 1st medium 






hs4 




resolution scan 


hs3: 


and 


byte ptr 


startl ,63 


limit 


to Ist high 










resolution scan 


; As ser t 


the new 


s t ar 1 1 , 


starth to the GDC. Assume that starth is 


; a 1 ways 


going to be although this is not a necessity. Issue the 


;PRAM command and rewrite the starting address 


of the GDC display 


; w i ndow 


. 










hs4: 


cal 1 


gdc_no t_ 


busy ;make sure 


the GDC is not busy 




mov 


al ,70h 


; issue the 


PRAM command 




out 


57h,al 










mov 


al , byte 


ptr startl ;fetch low 


byte of the starting 




out 


56h,al 


; address 






xor 


a 1 , a 1 


•,assume high byte is always 




out 


56h,al 










ret 










hscrol 1 


endp 










cseg 


ends 












end 
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Shadow Areas 

Most of the registers in the Graphics Option control more than one function. In addition, the regis- 
ters are write-only areas. In order to change selected bits in a register while retaining the settings of 
the rest, shadow images of these registers should be kept in motherboard memory. The current 
contents of the registers can be determined from the shadow area, selected bits can be set or reset 
by ORing or ANDing into the shadow area, and the result can be written over the existing register. 

Modifying the Color Map and the Scroll Map is also made easier using a shadow area in motherboard 
memory. These are relatively large areas and must be loaded during the time that the screen is 
inactive. It is more efficient to modify a shadow area in motherboard memory and then use a fast 
move routine to load the shadow area into the Map during some period of screen inactivity such as a 
vertical retrace. 

Bitmap Refresh 

The Graphics Option uses the same memory accesses that fill the screen with data to also refresh 
the memory. This means that if the screen display stops, the dynamic video memory will lose all the 
data that was being displayed within two milliseconds. In high resolution, it takes two scan Unes to 
refresh the memory (approximately 125 microseconds). In medium resolution, it takes four scan lines 
to refresh the memory (approximately 250 microseconds). During vertical retrace (1.6 miUiseconds) 
and horizontal retrace (10 microseconds) there is no refreshing of the memory. Under a worst case 
condition, you can stop the display for no more than two milliseconds minus four medium resolution 
scans minus vertical retrace or just about 150 microseconds. This is particularly important when 
programming the Scroll Map. 
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All write and read operations should take place during retrace time. Failure to limit reads and writes 
to retrace time will result in interference with the systematic refreshing of the dynamic RAMs as 
well as not displaying bitmap data during the read and write time. However, the GDC is usually 
programmed to limit its bitmap accesses to retrace time as part of the initialization process. 

Software Reset 

Whenever you reset the GDC by issuing the RESET command (a write of zero to port 57h), the 
Graphics Option must also be reset (a write of any data to port 50h). This is to synchronize the 
memory operations of the Graphics Option with the read/modify/write operations generated by the 
GDC. A reset of the Graphics Option by itself does not reset the GDC; they are separate reset 
operations. 

Setting Up Clock Interrupts 

With the Graphics Option installed on a Rainbow system, there are two 60 hz clocks available to the 
programmer — one from the motherboard and one from the Graphics Option. The motherboard clock 
is primarily used for a number of system purposes. However, you can intercept it providing that any 
routine that is inserted be kept short and compatible with the interrupt handler. Refer to the 

''init option'' procedure in Chapter 5 for a coding example of how to insert a new interrupt 

vector under MS-DOS. 

Clock interrupt types and vector addresses differ depending on the model of the motherboard as well 
as whether the interrupt is for the Graphics Option or for the motherboard. (Refer to Table 3.) 

It is important to keep all interrupt handlers short! Failure to do so can cause a system reset when 
the motherboard's MHFU line goes active. New interrupt handlers should restore any registers that 
are altered by the routine. 

Table 3. Clock Interrupt Parameters 





MOTHERBOARD 
MODEL 


INTERRUPT 
TYPE 


VECTOR 
ADDRESS 


GRAPHICS 
OPTION 


A 


22h 


88h 


B 


A2h 


288h 


MOTHERBOARD 


A 


20h 


80h 


B 


AOh 


280h 



LJ-0229 
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Operational Requirements 

All data modifications to the bitmap are performed by hardware that is external to the GDC. In this 
environment, it is a requirement that the GDC be kept in graphics mode and be programmed to 
write in Replace mode. Also, the internal write data patterns of the GDC must be kept as all ones 
for the external hardware to function correctly. The external hardware isolates the GDC from the 
data in the bitmap such that the GDC is not aware of multiple planes or incoming data patterns. 

Although it is possible to use the GDC's internal parameter RAM for soft character fonts and 
graphics characters, it is faster to use the option's Write Buffer. However, to operate in the GDC's 
native mode, the Write Buffer and Pattern Generator should be loaded with all ones, the Mode 
Register should be set to graphics mode, and the Foreground/Background Register should be loaded 
with FOh. 

When the Graphics Option is in Word Mode, the GDC's mask register should be filled with all ones. 
This causes the GDC to go on to the next word after each pixel operation is done. The external 
hardware in the meantime, has taken care of all sixteen bits on all four planes while the GDC was 
taking care of only one pixel. 

When the option is in Vector Mode, the GDC is also in graphics mode. The GDC's mask register is 
now set by the third byte of the cursor positioning command (CURS). The GDC will be able to tell 
the option which pixel to perform the write on but the option sets the mode, data and planes. 

Set-Up Mode 

When you press the SET-UP key on the keyboard, the system is placed in set-up mode. This, in 
turn, suspends any non-interrupt driven software and brings up a set-up screen if the monitor is 
displaying VT102 video output. If, however, the system is displaying graphics output, the fact that 
the system is in set-up mode will not be apparent to a user except for the lack of any further 
interaction with the graphics apphcation that has been suspended. The set-up screen will not be 
displayed. 

Users of applications that involve graphics output should be warned of this condition and cautioned 
not to press the SET-UP key when in graphics output mode. Note also that pressing the SET-UP 
key a second time will resume the execution of the suspended graphics software. 

In either case, whether the set-up screen is displayed or not, set-up mode accepts any and all 
keyboard data until the SET-UP key is again pressed. 



12-3 



Programming Notes 



Timing Considerations 

It is possible for an application to modify the associated hardware that is external to the GDC 
(registers, buffers, maps) before the GDC has completed all pending operations. If this should occur, 
the pending operations would then be influenced by the new values with unwanted results. 

Before changing the values in the registers, buffers, and color map, you must ensure that the GDC 

has completed all pending operations. The ''gdc not busy'' subroutine in the ''init option'' 

procedure in Chapter 5 is one method of checking that the GDC has completed all pending 
operations. 
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13 

Option Registers, Buffers, and 

IVIaps 



The Graphics Option uses a number of registers, buffers, and maps to generate graphic images and 
control the display of these images on a monochrome or color monitor. Detailed discussions of these 
areas may be found in Chapter 3 of this manual. 

I/O Ports 

The CPUs on the Rainbow system's motherboard use the following I/O ports to communicate with 
the Graphics Option: 

Port Function 

50h Graphics option software reset and resynchronization. 

51h Data input to area selected through port 53h. 

52h Data input to the Write Buffer. 
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53h Area select input to Indirect Register. 

54h Input to low-order byte of Write Mask. 

55h Input to high-order byte of Write Mask. 

56h Parameter input to GDC - Status output from GDC. 

57h Command input to GDC - Data output from GDC. 
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Indirect Register 

The Indirect Register is used to select one of eight areas to be written into. 



Load Data: 



Write data byte to port 53h. 



where: 



INDIRECT REGISTER 



7 


6 


5 


4 


3 


2 


1 






LJ-0230 



Data 


Active 


Function 


Byte 


Bit 




FEh 





selects the Write Buffer 


FDh 


1 


selects the Pattern Multiplier. (Pattern Multiplier must always be load 
ed before the Pattern Register) 


FBh 


2 


selects the Pattern Register. 


F7h 


3 


selects the Foreground/Background Register. 


EFh 


4 


selects the ALU/PS Register. 


DFh 


5 


selects the Color Map and resets the Color Map Address Counter to 
zero. 


BFh 


6 


selects the Graphics Option Mode Register. 


7Fh 


7 


selects the Scroll Map and resets the Scroll Map Address Counter to 



zero. 



NOTE 

If more than one bit is set to zero, more than one area will be selected and 
the results of subsequent write operations will be unpredictable. 



13-3 



Option Registers, Buffers, and Maps 



Write Buffer 

The Write Buffer is the incoming data source when the Graphics Option is in Word Mode. 

Select Area: write FEh to port 53h 

Clear Counter: write any value to port 51h 

Load Data: write up to 16 bytes to port 52h 



BYTE 

0,1 
2,3 
4,5 
6,7 
8,9 
10,11 
12,13 
14,15 



AS THE CPU ACCESSES IT 
(16 X 8-BIT RING BUFFER) 
7 



WORD 


1 

2 

3 
4 
5 
6 
7 



15 



AS THE GDC ACCESSES IT 
(8 X 16-BIT WORDS) 
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Write Mask Registers 

The Write Mask Registers control the writing of individual bits in a bitmap word. 

Select Area: no selection required 

Load Data: write low-order data byte to port 54h 

write high-order data byte to port 55h 



AS ACCESSED BY 
THE CPU 



PORT 55h 



i 



PORT 54h 



-0 7- 



WRITE MASK (HIGH) 



WRITE MASK (LOW) 



15- 



AS ACCESSED BY THE GDC 



where: 



bit = enables a write in the corresponding bit position of the word being 

displayed. 

bit = 1 disables a write in the corresponding bit position of the word being 

displayed. 
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Pattern Register 

The Pattern Register provides the incoming data when the Graphics Option is in Vector Mode. 



Select Area: 
Load Data: 



write FBh to port 53h 
write data byte to port 51h 



PATTERN 



I 

LJ-0233 



where: 



BITMAP 

WRITE 

CIRCUITRY 



Pattern is the pixel data to be displayed by the option when in Vector Mode. 
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Pattern Multiplier 

The Pattern Multiplier controls the recirculating frequency of the bits in the Pattern Register. 



Select Area: 
Load Data: 



write FDh to port 53h 
write data byte to port 51h 



where: 



UNUSED 



VALUE 



LJ-0234 



value is a number in the range of through 15 such that 16 minus this value is the 
factor that determines when the Pattern Register is shifted. 
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Foreground/Background Register 

The Foreground/Background Register controls the bit/plane input to the bitmap. 

Select Area: write F7h to port 53h 

Load Data: write data byte to port 51h 



7 






DATA BYTE 









7 


6 


5 


4 


3 


2 


1 






FOREGROUND BACKGROUND 
REGISTER I REGISTER 

I LJ0235 



where: 



Bits 

0-3 are the bits written to bitmap planes 0-3 respectively when the option is in RE- 
PLACE mode and the incoming data bit is a zero. 

If the option is in OVERLAY or COMPLEMENT mode and the incoming data bit is 
a zero, there is no change to the bitmap value. 

4-7 are the bits written to bitmap planes 4-7 respectively when the option is in RE- 
PLACE or OVERLAY mode and the incoming data bit is a one. 

If the option is in COMPLEMENT mode and the incoming data bit is a one, the 
Foreground bit determines the action. If it is a one, the bitmap value is inverted; if 
it is a zero, the bitmap value is unchanged. 
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ALU/PS Register 

The ALU/PS Register controls the logic used in writing to the bitmap and the inhibiting of writing to 
specified planes. 

Select Area: write EFh to port 53h 

Load Data: write data byte to port 51h 



7 DATA BYTE 



7 


6 


5 


4 


3 


2 


1 





UNUSED 


ALU 


PLANE SELECT 



where: 



Bit 


Value 


Function 








enable writes to plane 




1 


inhibit writes to plane 


1 





enable writes to plane 




1 


inhibit writes to plane 1 


2 





enable writes to plane 2 




1 


inhibit writes to plane 2 


3 





enable writes to plane 3 




1 


inhibit writes to plane 3 


5,4 


00 


place option in REPLACE mode 




01 


place option in COMPLEMENT mode 




10 


place option in OVERLAY mode 




11 


Unused 


7,6 




Unused 



13-9 



Option Registers, Buffers, and Maps 



Color Mop 

The Color Map translates bitmap data into the monochrome and color intensities that are appHed to 
the video monitors. 



Select Area: 
Coordinate: 
Load Data: 



write DFh to port 53h (also clears the index counter) 
wait for vertical sync interrupt 
write 32 bytes to port 51h 



2ND 16 BYTES 
LOADED BY 
THE CPU 



1 ST 1 6 BYTES 
LOADED BY 
THE CPU 



MONO. 
DATA 


BLUE 
DATA 


RED 
DATA 


GREEN 
DATA 


BYTE 1 7 


BYTE 1 


BYTE 1 8 


BYTE 2 


BYTE 1 9 


BYTE 3 


BYTE 20 


BYTE 4 


BYTE 21 


BYTE 5 


BYTE 22 


BYTE 6 


BYTE 23 


BYTE 7 



BYTE 32 



BYTE 1 6 
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Mode Register 

The Mode Register controls a number of the Graphics Option's operating characteristics. 

Select Area: write BFh to port 53h 

Load Data: write data byte to port 51h 



7 


6 


5 


4 


3 


2 


1 
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where: 



Bit 


Value 


Function 








place option in medium resolution mode 




1 


place option in high resolution mode 


1 





place option into word mode 




1 


place option into vector mode 


3,2 


00 


select plane for readback operation 




01 


select plane 1 for readback operation 




10 


select plane 2 for readback operation 




11 


select plane 3 for readback operation 


4 





enable readback operation 




1 


enable write operation 


5 





enable writing to the Scroll Map 




1 


disable writing to the Scroll Map 


6 





disable vertical sync interrupts to CPU 




1 


enable vertical sync interrupts to CPU 


7 





disable video output from Graphics Option 




1 


enable video output from Graphics Option 



NOTE 

The Mode Register must be reloaded following any write to port 50h 
(software reset). 
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Scroll Map 

The Scroll Map controls the location of each line displayed on the monitor screen. 



Preliminary: 
Select Area: 
Coordinate: 
Load Data: 
Final: 



enable Scroll Map writing (Mode Register bit 5 = 0) 
write 7Fh to port 53h (also clears the index counter) 
wait for vertical sync interrupt 
write 256 bytes to port 51h 

disable Scroll Map writing (Mode Register bit 5 = 1) 



where: 



GDC 



GDC LINE 
ADDRESS 



(BITS 6-13 



256 X 8 

RECIRCULATING 
RING BUFFER 
7 




BITMAP LINE 
ADDRESS 
(BITS 6-13) 



'BIT MAP 

LJ0239 



GDC Line is the line address as generated by the GDC and used as an index into 

Address the Scroll Map. 

Bitmap Line is the offset line address found by indexing into the Scroll Map. It be- 

Address comes the new line address of data going into the bitmap. 
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The GDC has an 8-bit Status Register and a 16 x 9-bit first-in, first-out (FIFO) Buffer that provide 
the interface to the Graphics Option. The Status Register suppHes information on the current activity 
of the GDC and the status of the FIFO Buffer. The FIFO Buffer contains GDC commands and 
parameters when the GDC is in write mode. It contains bitmap data when the GDC is in read mode. 

Status Register 

The GDC's internal status can be interrogated by doing a read from port 56h. The Status Register 
contents are as follows: 



where: 



7 


6 


5 


4 


3 


2 


1 






LJ0240 



Bit Status 

DATA READY 

1 FIFO FULL 

2 FIFO EMPTY 

3 DRAWING IN 
PROGRESS 



4 DMA EXECUTE 

5 VERTICAL SYNC 
ACTIVE 

6 HORIZONTAL 
SYNC ACTIVE 

7 LIGHT PEN DE- 
TECTED 



Explanation 

When set, data is ready to be read from the FIFO. 

When set, the command/parameter FIFO is full. 

When set, the command/parameter FIFO is completely empty. 

When set, the GDC is performing a drawing function. Note, 
however, that this bit can be cleared before the DRAW com- 
mand is fully completed. The GDC does not draw continuously 
and this bit is reset during interrupts to the write operation. 

Not used. 

When set, the GDC is doing a vertical sync. 
When set, the GDC is doing a horizontal sync. 
Not used. 
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FFO Buffer 



You can both read from and write to the FIFO Buffer. The direction that the data takes through the 
buffer is controlled by the Rainbow system using GDC commands. GDC commands and their associ- 
ated parameters are written to ports 57h and 56h respectively. The GDC stores both in the FIFO 
Buffer where they are picked up by the GDC command processor. The GDC uses the ninth bit in the 
FIFO Buffer as a flag bit to allow the command processor to distinguish between commands and 
parameters. Contents of the bitmap are read from the FIFO using reads from port 57h. 



FLG 
8 



DATA BYTE 



COMMANDS AND 
PARAMETERS 
FROM THE CPU — 



BITMAP DATA - 
TO THE CPU 



-COMMANDS AND 
PARAMETERS TO 
THE COMMAND 
PROCESSOR 

DATA FROM 
THE BITMAP 



14 



15 



where: 



fig is a flag bit to be interpreted as: 

- data byte is a parameter 

1 - data byte is a command 

data byte is a GDC command or parameter 

When you reverse the direction of flow in the FIFO Buffer, any pending data in the FIFO is lost. If a 
read operation is in progress and a command is written to port 56h, the unread data still in the FIFO 
is lost. If a write operation is in progress and a read command is processed, any unprocessed 
commands and parameters in the FIFO Buffer are lost. 
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Introduction 

This chapter contains detailed reference information on the GDC commands and parameters sup- 
ported by the Graphics Option. The commands are Hsted in alphabetical order within functional 
category as follows: 

• Video Control Commands 



CCHAR - Specifies the cursor and character row heights 

RESET - Resets the GDC to its idle state 

SYNC - Specifies the video display format 

VSYNC - Selects Master/Slave video synchronization mode 

• Display Control Commands 

BCTRL - Controls the blanking/unblanking of the display 

CURS - Sets the position of the cursor in display memory 

PITCH - Specifies the width of display memory 

PRAM - Defines the display area parameters 

START - Ends idle mode and unblanks the display 

ZOOM - Specifies zoom factor for the graphics display 
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• Drawing Control Commands 



FIGD - Draws the figure as specified by FIGS command 

FIGS - Specifies the drawing controller parameters 

GCHRD - Draws the graphics character into display memory 

MASK - Sets the mask register contents 

WDAT - Writes data words or bytes into display memory 

• Data Read Commands 

RDAT - Reads data words or bytes from display memory 
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Video Control Commands 

CCHAR - Specify Cursor and Character Characteristics 

Use the CCHAR command to specify the cursor and character row heights and characteristics. 

COMMAND BYTE 





7 


6 


5 


4 


3 


2 


1 










1 








1 





1 


1 


PARAMETER BYTES 
7 6 5 


4 


3 


2 


1 





P1 


DC 








LR 


P2 


BR(LO) 


SC 


CTOP 


P3 


CBOT 


BR(HI) 
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where: 

DC controls the display of the cursor 

- do not display cursor 

1 - display the cursor 

LR is the number of lines per character row, minus 1 

BR is the blink rate (5 bits) 

SC controls the action of the cursor 

- bHnking cursor 

1 - steady cursor 

CTOP is the cursor's top line number in the row 

CBOT is the cursor's bottom line number in the row 
(CBOT must be less than LR) 
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RESET - Reset the GDC 

Use the RESET command to reset the GDC. This command blanks the display, places the GDC in 
idle mode, and initializes the FIFO buffer, command processor, and the internal counters. If parame- 
ter bytes are present, they are loaded into the sync generator. 

COMMAND BYTE 





7 


6 


5 






4 


3 




2 


1 

































PARAMETER BYTES 
7 6 5 






4 


3 




2 


1 





P1 








C 


F 


1 


D 


G 


S 


P2 


AW 


P3 


VS(LO) 


HS 


P4 


HFP 


VS(HI) 


P5 








HBP 


P6 








VFP 


P7 


AL(LO) 


P8 


VBP 


AL(HI) 
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where: 

CG sets the display mode for the GDC 

00 - mixed graphics and character mode 

01 - graphics mode only 

10 - character mode only 

11 - invalid 

IS controls the video framing for the GDC 

00 - noninterlaced 

01 - invalid 

10 - interlaced repeat field for character displays 

11 - interlaced 

D controls the RAM refresh cycles 

- no refresh - static RAM 

1 - refresh - dynamic RAM 

F controls the drawing time window 

- drawing during active display time and retrace blanking 

1 - drawing only during retrace blanking 

AW active display words per line minus 2; must be an even number 

HS horizontal sync width minus 1 

VS vertical sync width 

HFP horizontal front porch width minus 1 

HBP horizontal back porch width minus 1 

VFP vertical front porch width 

AL active display lines per video field 

VBP vertical back porch width 
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SYNC - Sync Format Specify 

Use the SYNC command to load parameters into the sync generator. The GDC is neither reset nor 
placed in idle mode. 

COMMAND BYTE 
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1 


1 


DE 
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where: 

DE controls the display 

- disables (blanks) the display 

1 - enables the display 

PARAMETER BYTES 
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P1 
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F 


1 


D 


G 


S 


P2 


AW 


P3 


VS(LO) 


HS 


P4 


HFP 


VS(HI) 


P5 








HBP 


P6 








VFP 


P7 


AL(LO) 


P8 


VBP 


AL(HI) 
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where: 

CG sets the display mode for the GDC 

00 - mixed graphics and character mode 

01 - graphics mode only 

10 - character mode only 

11 - invalid 

IS controls the video framing for the GDC 

00 - noninterlaced 

01 - invalid 

10 - interlaced repeat field for character displays 

11 - interlaced 

D controls the RAM refresh cycles 

- no refresh - static RAM 

1 - refresh - dynamic RAM 

F controls the drawing time window 

- drawing during active display time and retrace blanking 

1 - drawing only during retrace blanking 

AW active display words per line minus 2; must be an even number 

HS horizontal sync width minus 1 

VS vertical sync width 

HFP horizontal front porch width minus 1 

HBP horizontal back porch width minus 1 

VFP vertical front porch width 

AL active display lines per video field 

VBP vertical back porch width 
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VSYNC - Vertical Sync Mode 

Use. the VSYNC command to control the slave/master relationship whenever multiple GDC's are 
used to contribute to a single image. 



where: 



COMMAND BYTE 
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1 


1 
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M 
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M sets the synchronization status of the GDC 

- slave mode (accept external vertical sync pulses) 

1 - master mode (generate and output vertical sync pulses) 
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Display Control Commands 
BCTRL - Control Display Blanking 

Use the BCTRL command to specify whether the display is blanked or enabled. 
COMMAND BYTE 
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1 


1 





DE 
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where: 

DE controls the display 

- disables (blanks) the display 

1 - enables the display 
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CURS - Specify Cursor Position 

Use the CURS command to set the position of the cursor in display memory. In character mode the 
cursor is displayed for the length of the word. In graphics mode the word address specifies the word 
that contains the starting pixel of the drawing; the dot address specifies the pixel within that word. 



COMMAND BYTE 
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PI 


EAD(LO) 


P2 


EAD(MID) 




















P3 


dAD 








EAD(HI) 



-GRAPHICS MODE ONLY 



where: 



EAD is the execute word address (18 bits) 
dAD is the dot address within the word 
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PITCH - Specify Horizontal Pitcli 

Use the PITCH command to set the width of the display memory. The drawing processor uses this 
value to locate the word directly above or below the current word. It is also used during display to 
find the start of the next line. 

COMMAND BYTE 
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where: 

P is the number of word addresses in display memory in the horizontal direction 
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PRAM - Load the Parameter RAM 

Use the PRAM command to load up to 16 bytes of information into the parameter RAM at specified 
adjacent locations. There is no count of the number of parameter bytes to be loaded; the sensing of 
the next command byte stops the load operation. Because the Graphics Option requires that the GDC 
be kept in graphics mode, only parameter bytes one through four, nine, and ten are used. 

COMMAND BYTE 



7 


6 


5 


4 


3 


2 1 
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1 
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SA 
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where: 

SA is the start address for the load operation (Pn - 1) 
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PARAMETER BYTES 

7 6 5 4 3 2 



1 



P1 


SAD(LO) 


P2 


SAD(MID) 


P3 


LEN(LO) 








SAD(HI) 


P4 


WD 


IM 


LEN(HI) 



P5 



P8 



UNUSED 



UNUSED 



P9 


1 


1 


1 


1 


1 


1 


1 


1 


P10 


1 


1 


1 


1 


1 


1 


1 


1 



P1 1 



P16 



UNUSED 



UNUSED 



where: 



SAD is the start address of the display area (18 bits) 
LEN is the number of Hnes in the display area (10 bits) 
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WD sets the display width 

- one word per memory cycle (16 bits) 

1 - two words per memory cycle (8 bits) 

IM sets the current type of display when the GDC is in mixed graphics and character 

mode 

- character area 

1 - image or graphics area 

NOTE 

When the GDC is in graphics mode, the IM bit must be a zero. 
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START - Start Display and End Idle Mode 

Use the START command to end idle mode and enable the video display. 

COMMAND BYTE 
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ZOOM - Specify the Zoom Factor 

Use the ZOOM command to set up a magnification factor of 1 through 16 (using codes through 
15) for the display and for graphics character writing. 

COMMAND BYTE 
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where: 

DISP is the zoom factor (minus one) for the display 

GCHR is the zoom factor (minus one) for graphics character writing and area fills 
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GDC Connnnands 



Drawing Control Commands 
FIGD - Start Figure Drawing 

Use the FIGD command to start drawing the figure specified with the FIGS command. This com- 
mand causes the GDC to: 

• load the parameters from the parameter RAM into the drawing controller, and 

• start the drawing process at the pixel pointed to by the cursor: Execute Word Address (EAD) 
and Dot Address within the word (dAD) 

COMMAND BYTE 
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FIGS - Specify Figure Drawing Parameters 

Use the FIGS command to supply the drawing controller with the necessary figure type, direction, 
and drawing parameters needed to draw figures into display memory. 

COMMAND BYTE 





7 


6 


5 


4 


3 


2 


1 










1 








1 


1 








PARAMETER BYTES 
7 6 5 


4 


3 


2 


1 





P1 


SL 


R 


A 


GC 


L 


DIR 


DO 

rz 


DC(LO) 
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GD 


DC(HI) 
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P5 








D(HI) 


P6 


D2(L0) 


P7 








D2(HI) 
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D1(L0) 
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D1(HI) 
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DM(HI) 
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where: 



SL 


Slanted Graphics Character ^ 




R 


Rectangle 


Figure Type Select Bits 


A 


Arc/Circle 


(see vahd 


GC 


Graphics Character 


combinations 
below) 


L 


Line (Vector) ^ 


DIR 


is the drawing direction base (see definitions below) 


DC 


is the DC drawing parameter (14 bits) 


GD 


is the graphic drawing flag used in mixed graphics and character mode 


D 


is the D drawing parameter (14 bits) 


D2 


is the D2 drawing parameter (14 bits) 


Dl 


is the Dl drawing parameter (14 bits) 


DM 


is the DM drawing parameter (14 bits) 



FIGURE TYPE SELECT BITS (VALID COMBINATIONS) 



SL R A GC L 


OPERATION 





CHARACTER DISPLAY MODE DRAWING, INDIVIDUAL DOT 
DRAWING, WDAT, AND RDAT 


1 


STRAIGHT LINE DRAWING 


10 


GRAPHICS CHARACTER DRAWING AND AREA FILL WITH 
GRAPHICS CHARACTER PATTERN 


10 


ARC AND CIRCLE DRAWING 


10 


RECTANGLE DRAWING 


10 10 


SLANTED GRAPHICS CHARACTER DRAWING A^D SLANTED 
AREA FILL 
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DRAWING DIRECTION BASE (DIR) 

[101] [100] [Oil] 




[1 1 0] [START] ► [01 0] 

[111] [000] [001] 

LJ-0252 
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GDC Commands 



GCHRD - Start Graphics Character Draw and Area Fill 

Use the GCHRD command to initiate the drawing of the graphics character or area fill pattern that 
is stored in the Parameter RAM. The drawing is further controlled by the parameters loaded by the 
FIGS command. Drawing begins at the address in display memory pointed to by the Execute Address 
(EAD) and Dot Address (dAD) values. 

COMMAND BYTE 
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MASK - Load the Mask Register 

Use the MASK command to set the value of the 16-bit Mask Register that controls which bits of a 
word can be modified during a Read/Modify/Write (RMW) cycle. 

COMMAND BYTE 
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P2 M(HI) 
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where: 

M is the bit configuration to be loaded into the Mask Register (16 bits). Each bit in 

the Mask Registercontrols the writing of the corresponding bit in the word being 
processed as follows: 

- disable writing 

1 - enable writing 
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GDC Commands 



WDAT - Write Data Into Display Memory 

Use the WDAT command to perform RMW cycles into display memory starting at the location 
pointed to by the cursor Execute Word Address (EAD). Precede this command with a FIGS com- 
mand to supply the writing direction (DIR) and the number of transfers (DC). 



COMMAND BYTE 



7 6 5 4 3 2 1 









1 


TYPE 





MOD 



LJ-0255 



where: 



TYPE is the type of transfer 

00 - word transfer (first low then high byte) 

01 - invalid 

10 - byte transfer (low byte of the word only) 

11 - byte transfer (high byte of the word only) 

MOD is the RMW memory logical operation 

00 - REPLACE with Pattern 

01 - COMPLEMENT 

10 - RESET to Zero 

11 - SET to One 



PARAMETER BYTES 



P1 WORD(LO) OR BYTE 



P2 WORD(HI) 
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where: 

WORD is a 16-bit data value 
BYTE is an 8-bit data value 
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Data Read Commands 

RDAT - Read Data From Display Memory 

Use the RDAT command to read data from display memory and pass it through the FIFO buffer and 
microprocessor interface to the host system. Use the CURS command to set the starting address 
and the FIGS command to supply the direction (DIR) and the number of transfers(DC). The type of 
transfer is coded in the command itself. 



COMMAND BYTE 



7 6 5 4 3 2 1 



1 





1 


TYPE 





MOD 
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where: 

TYPE is the type of transfer 

00 - word transfer (first low then high byte) 

01 - invalid 

10 - byte transfer (low byte of the word only) 

11 - byte transfer (high byte of the word only) 

MOD is the RMW memory logical operation 

00 - REPLACE with Pattern 

01 - COMPLEMENT 

10 - RESET to Zero 

11 - SET to One 

NOTE 

The MOD field should be set to 00 if no modification to the video buffer is 
desired. 
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A 



Option Specification Summary 



Physical Specifications 

The Graphics Option Video Subsystem is a 5.7'' X 10.0'', high density, four-layer PCB with one 40- 
pin female connector located on side 1. This connector plugs into a shrouded male connector located 
on the system module. The option module is also supported by two standoffs. 

Environmental Specifications 
Temperature 

• Operating ambient temperature range is 10 to 40 degrees C. 

• Storage temperature is -40 to 70 degrees C. 

Humidity 

• 10% to 90% non-condensing 

• Maximum wet bulb, 28 degrees C. 

• Minimum dew point, 2 degrees C. 



A-1 



Option Specification Summary 



Altitude 

• Derate maximum operating temperature 1 degree per 1,000 feet elevation 

• Operating limit: 22.2 in. Hg. (8,000 ft.) 

• Storage limit: 8.9 in Hg. (30,000 ft.) 

Power Requirements 





Calculated Typical 


Calculated Maximum 


+5V DC (+/-5%) 


3.05 amps 


3.36 amps 


+12V DC (+/-10%) 


180 mA 


220 mA 



Standards and Regulations 

The Graphics Option module complies with the following standards and recommendations: 

• DEC Standard 119 - Digital Product Safety (covers UL 478, UL 114, CSA 22.2 No. 154, VDE 
0806, and lEC 380) 

• lEC 485 - Safety of Data Processing Equipment 

• EI A RSI 70 - Electrical Performance Standards - Monochrome Television Studio Facilities 

• CCITT Recommendation V.24 - List of Definitions for Interchange Circuit Between Data Ter- 
minal Equipment and Data Circuit Terminating Equipment 

• CCITT Recommendation V.28 - Electrical Characteristics for Unbalanced Double-Current 
Interchange Circuits 
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Option Specification Summary 



Part and Kit Numbers 

Graphics Option 
Hardware: 

Printed Circuit Board 

Color RGB Cable 
Software and Documentation: 

Rainbow Color/Graphics Option Installation Guide 

Rainbow Color/Graphics Option Programmer's Reference Guide 

Rainbow GSX-86 Programmer's Reference Manual 

Rainbow GSX-86 Getting Started 

Rainbow Diagnostic/GSX-86 Diskette 
Rainbow 100 CP/M-86/80 Vl.O Technical Documentation 
Rainbow 100 MS-DOS V2.01 Technical Documentation 



PCIXX-BA 

54-15688 
BCC17-06 

EK-PCCOL-IN-001 

AA-AE36A-TV 

AA-V526A-TV 

AA-W964A-TV 

BL-W965A-RV 

QV043-GZ 

QV025-GZ 
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B 

Rainbow Graphics Option - 

Block Diagram 
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PARAMETER 



STATUS 
COMMAND 



READBACK DATA 



GDC WRITE 



FIFO 
(16X9) 



PIXEL 
MASK 



SCROLL MAP 
INDEX 
COUNTER 
(0—255) 



WRITE MASK 
(2 X 8) 
-L. 



1 f 

(g) (54) 



GDC DATA 



GDC ADDRESS BITS 0—5 



16 



GDC ADDRESS 



BITS 6—1 3 




PIXEL IN WORD 



WRITE ENABLE 



PLANE 
SELECT 
(1 X4) 



ALU 

FUNCTION 
(1 X2) 



PLANE 



WRITE 
ENABLE 



CLOCK 



AND 




PATTERN 

MULTIPLIER 

(0-15) 



SHIFT 
CLOCK 



PATTERN 
REGISTER 
(1 X8) 



WRITE BUFFER 
INDEX COUNTER 
(0-15) 



~} 

RESET 

I 



WRITE 

BUFFER 

(16X8) 



® 



SCROLL 
MAP 
(256 X 8) 



PIXEL 
PLANE 




WRITE 
ENABLE 



1/ 

14 



BIT MAP 
(2/4 PLANES) 



DATA IN 

A 



LOGIC UNIT 

f OVERLAY 
REPLACE 
COMPLEMENT 






DATA 



OUT 



7f 



/ 


/ 

4 / 


^4 


FOREGROUND/ 
REGISTE 


BACKGROUND 
R (2 X 4) 







/^3/l3\ 
V5iy 



READ 



ENABLE 



PLANE 



SELECT 




® 
I 

3A 

I 



LOAD 



INDIRECT REGISTER 


BIT 


SELECTED AREA 





WRITE BUFFER (INDEX COUNTER CLEAR) 


1 


PATTERN MULTIPLIER 


2 


PATTERN REGISTER 


3 


FOREGROUND/BACKGROUND REGISTER 


4 


ALU FUNCTION/PLANE SELECT REGISTER 


5 


COLOR/MONO MAP (INDEX COUNTER CLEAR) 


6 


MODE REGISTER 


7 


SCROLL MAP (INDEX COUNTER CLEAR) 



VIDEO OUTPUT 
CIRCUITRY 
(SHIFT REGISTER) 



COLOR/MONO MAP 
INDEX COUNTER 
(0-31) 



RESET 
I 

(^53/15^ 



/4 





® ® 




1 1 

RESET LOAD 

1 \ 


MODE REGISTER 


BIT 


CONTROLLED FUNCTION 





MEDIUM/HIGH RESOLUTION MODE 


1 


WORD/VECTOR MODE 


2 


READBACK MODE PLANE SELECT (LSB) 


3 


READBACK MODE PLANE SELECT (MSB) 


4 


WRITE/READ MODE 


5 


SCROLL MAP UPDATE 


6 


INTERRUPT REQUEST 


7 


VIDEO OUTPUT DATA BLANKING 



ADDRESS 




BLUE 
(16X4) 



GREEN 
(16X4) 

COLOR 



MAP 

RED 
(16X4) 



MONO 
(16X4) 



/I 




GRAPHICS/ 
VIDEO 
SELECT 

^0A/D2) 

KBD/RCV 



N/C' 



KBD/TXD 
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MOTHERBOARD 
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m 
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+12V 
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Figure 15. Rainbow Graptiics Option — Bloci< Diagram 
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Getting Help 



Help Line Phone Numbers 



Country 


Phone Number 


U.S.A. 


(800) DEC-8000 


Canada 


(800) 267-5251 


United Kingdom 


(0256) 59 200 


Belgium 


(02)-24 26 790 


West Germany 


(089) 95 91 66 44 


Italy 


(02)-617 53 81 or 617 53 82 


Japan 


(0424) 64-3302 


Denmark 


(04)-30 10 05 


Spain 


(l)-73 34 307 


Finland 


(90)-42 33 32 


Holland 


(1820)-31 100 


Switzerland 


(01)-810 51 21 


Sweden 


(08)-98 88 35 


Norway 


(02)-25 64 22 


France 


(l)-687 31 52 


Austria 


(222)-67 76 41 extension 444 


Australia 





Sydney (02) 412-5555 

All other areas (008) 226377 
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Index 



Address conversion 

from pixel coordinates 3-5 
Address logic 3-2 
Altitude specifications 1-2 
ALU functions 

COMPLEMENT 4-8, 4-18 

OVERLAY 4-9, 4-19 

REPLACE 4-8, 4-18 
ALU/PS Register 4-8, 6-1 

bit definitions 13-9 

load data 13-9 

select 13-9 
Arithmetic Logic Unit 4-8 



B 

Background Register 4-6 
BCTRL command 15-9 
Bit definitions 
ALU/PS Register 13-9 
BCTRL command 15-9 
CCHAR command 15-3 
CURS command 15-10 
FIFO Buffer 14-2 
FIGS command 15-18 



Foreground/Background Register 
13-8 

GDC Status Register 14-1 
Indirect addressing 4-2 
Indirect Register 13-3 
MASK command 15-22 
Mode Register 13-11 
PITCH command 15-11 
PRAM command 15-12 
RDAT command 15-24 
RESET command 15-4 
Status Register 14-1 
SYNC command 15-6 
VSYNC command 15-8 
WDAT command 15-23 
Write Mask Registers 13-5 
ZOOM command 15-16 
Bitmap 1-2 
data 3-6 

line address 13-12 
modifications 12-3 
organization 3-5 
reading from 10-1 
refreshing 12-1 
Bitmap planes 
high resolution 3-6 
medium resolution 3-6 
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Index 



C 

CCHAR command 15-3 

initial value 5-8 
Character 

characteristics 15-3 
Characteristics of 

character 15-3 

cursor 15-3 
Circle 

display a 8-9 
Clear index counter 

Color Map 13-10 

Scroll Map 13-12 

Write Buffer 13-4 
Clock interrupt 

parameters 12-2 

types 12-2 

vector addresses 12-2 
Clock interrupts 12-2 
Clocks 

Graphics Option 12-2 

motherboard 12-2 
Color intensities 4-9 

available 1-1 

conversion to drive voltages 4-13 

displayed 1-1 
Color Map 3-6, 4-9 

high resolution 4-11 

load data 13-10 

loading 4-12 

medium resolution 4-10 

select 13-10 
Color monitor 2-3 
Components 

hardware 1-1 
Configuration 

Color Map 4-9 
Configurations 

color monitor 2-3 

dual monitors 2-4 

monochrome monitor 2-2 
Control display blanking 15-9 
Control graphics output 5-24 
Control multiple GDCs 15-8 
Conversion 

color intensities to drive voltages 
4-13 



Conversion table 
color intensities to drive voltages 
4-13 

CURS command 15-10 
Cursor 

characteristics 15-3 

positioning 15-10 

D 

Data flow in FIFO Buffer 14-2 
Data logic 3-2 
Data path 

color monitor 2-3 

dual monitors 2-4 

monochrome monitor 2-2 
Data patterns 3-2 
Data read commands 15-2 
Digital-to-analog converters 4-13 
Disable 

individual bits 4-4 

plane writes 4-8 
Display 

a circle 8-9 

a pixel 8-4 

a vector 8-5 
Display blanking 15-9 
Display control commands 15-1 
Display logic 3-6 
Display memory 1-2, 3-2 

GDC access to 3-3 

organization 3-5 
Display planes 1-2 
Displaying data from memory 7-1 
Drawing control commands 15-2 
Dual monitors 2-4 

E 

Enable 

individual bits 4-4 

plane writes 4-8 
End idle mode 15-15 
Environmental specifications 1-1 
Examples 

CCP/M version test 5-5 

CP/M version test 5-2 

disable monitor output 5-25 
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display a circle 8-9 
display a pixel 8-4 
display a vector 8-6 
display data from memory 7-1 
enable monitor output 5-24 
horizontal scrolling 11-4 
initialize Graphics Option 5-9 
load Color Map 5-26 
loading ALU/PS Register 6-1 
loading Foreground/Background Reg- 
ister 6-2 

loading Pattern Multiplier 8-3 

loading Pattern Register 8-1 

modify color data 5-26 

MS-DOS version test 5-3 

no-op word write 10-5 

option present test 5-1 

read entire bitmap 10-2 

set area to a color 7-4 

vertical scrolling 11-2 

write a text string 9-38 

writing byte-aligned character 9-1 

F 

FIFO Buffer 3-9, 14-2 

bit definitions 14-2 

data flow 14-2 

flag bit 3-9 

read mode 3-9 

write mode 3-9 
FIGD command 15-17 
FIGS command 15-18 
Figure drawing parameters 15-18 
Foreground Register 4-6 
Foreground/Background Register 4-6, 
6-2 

bit definitions 13-8 
load data 13-8 
select 13-8 
Full-screen scrolling 4-16 



G 

GCHRD command 15-21 
GDC 1-1 

command processor 14-2 

in native mode 12-3 

initialize 5-7 
GDC access to bitmap 3-7 
GDC addresses 3-5 
GDC buffers 

reference data 14-1 
GDC command bytes 3-9 
GDC command logic 3-9 
GDC commands 15-1 

BCTRL 15-9 

CCHAR 15-3 

CURS 15-10 

FIGD 15-17 

FIGS 15-18 

GCHRD 15-21 

in FIFO Buffer 14-2 

MASK 15-22 

PITCH 15-11 

PRAM 15-12 

RDAT 15-24 

RESET 12-2, 15-4 

START 15-15 

SYNC 15-6 

VSYNC 15-8 

WDAT 15-23 

ZOOM 15-16 
GDC functions 1-2 
GDC line address 13-12 
GDC Mask Register 15-22 
GDC parameter bytes 3-9 
GDC parameters 

in FIFO Buffer 14-2 
GDC registers 

reference data 14-1 
GDC reset 5-6, 12-2 

parameters 5-6 
GDC Status Register 

bit definitions 14-1 
Graphics Display Controller 1-1 
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Graphics Option 1-1 

I/O ports 13-1 

in vector mode 12-3 

in word mode 12-3 

initialize 5-8 
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HOW TO ORDER 
ADDITIONAL DOCUMENTATION 



If you want to order additional documentation by phone: 



And you live in: 

New Hampshire, Alaska or 
Hawaii 



Call: 

603-884-6660 



Continental USA or Puerto Rico 1-800-258-1710 



Canada (Ottawa-Hull) 
Canada (British Columbia) 
Canada (all other) 



613-234-7726 



1-800-267-6146 



112-800-267-6146 



Between the hours of: 

8:30 AM and 6:00 PM 
Eastern Time 

8:30 AM and 6:00PM 
Eastern Time 

8:00 AM and 5:00 PM 
Eastern Time 

8:00 AM and 5:00 PM 
Eastern Time 

8:00 AM and 5:00 PM 
Eastern Time 



If you want to order additional documentation by direct mail: 



And you live in: 

USA or Puerto Rico 



Canada 



Other than USA, 
Puerto Rico or Canada 



Write to: 

DIGITAL EQUIPMENT CORPORATION 
ATTN: Peripherals and Supplies Group 
P.O. Box CS2008 
Nashua, NH 03061 

NOTE: Prepaid orders from Puerto Rico must be 
placed with the local DIGITAL subsidiary 
(Phone 809-754-7575) 

DIGITAL EQUIPMENT OF CANADA LTD. 
940 Belfast Road 
Ottawa, Ontario KIG 4C2 
Attn: P&SG Business Manager 

DIGITAL EQUIPMENT CORPORATION 
Peripherals and Supplies Group 
P&SG Business Manager 

c/o Digital's local subsidiary or approved distributor 



TO ORDER MANUALS WITH EK PART NUMBERS 
WRITE OR CALL 

P&CS PUBLICATIONS 
Circulation Services 
10 Forbes Road 
NR03/W3 

Northboro, Massachusetts 01532 
(617)351-4325 



Rainbow™ 
Color/Graphics Option 
Programmer's Reference Guide 
AA-AE36A-TV 



READER'S COMMENTS 

Did you find this manual understandable, usable, and well-organized? Please make suggestions for 
improvement. 



Did you find errors in this manual? If so, specify the error and the page number. 



Please indicate the type of reader that you most nearly represent. 

□ First-time computer user 

□ Experienced computer user 

□ Application package user 

□ Programmer 

□ Other (please specify) 

Name 

Date 

Organization 

Street 

City 

State 

Zip Code 

or Country 
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